fs-fio/fio
71.1
Strong · 15 November 2026
10.5k
lines of production code
F#
with Python
4
measurements over time
What this system is
Features
Added packaging and stress-test automation scripts
The repository now includes two new shell scripts to streamline development workflows. The \pack.sh\ script automates the creation of NuGet packages by running \dotnet pack\ in Release mode and outputting the artifacts to a dedicated directory. Additionally, \stress-test.sh\ provides a tool for running the test suite repeatedly a specified number of times to identify flaky tests, reporting the total passed and failed counts upon completion.
scripts · high confidence
New ZipRace benchmark and A/B comparison tool for parallel combinators
The benchmark suite now includes a new ZipRace benchmark that measures the per-invocation cost of the ZipPar and RaceFirst parallel combinators, helping to regression-guard the runtime primitives for fork, settle, and join. Additionally, a new compare.py script has been added to the benchmarks directory, allowing users to generate markdown reports that compare execution time and memory allocation deltas between two sets of BenchmarkDotNet results, with configurable thresholds for flagging regressions and wins. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Minor code cleanup in benchmark effect definitions.
benchmarks · low confidence · unverified
Behavioural changes
1 commit (0 fixes) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 1 commit, 82 files: “Release 0.6.0-beta (\#80)” (refs \#80). Also in this area: Benchmark suite cleanup, CLI flag expansion, and HTTP handler type safety; Initial repository scaffolding and documentation.
FIO.Benchmarks · low confidence · unverified
15 commits (1 fix) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 15 commits (1 fix), 11 files: “Cleanup commit”; “feat: update readme and bump version (\#63)”; “feat: add new logo (\#61)”; and 12 more (refs \#63, \#61, \#58, \#60, \#56, …).
(repo-wide) · low confidence · unverified
Improved HTTP route matching and server shutdown handling
Route pattern matching now uses invariant culture for integer parsing, ensuring consistent behavior regardless of system locale, and the HTTP server now supports a configurable shutdown timeout to allow in-flight requests to complete gracefully before stopping. Additionally, the routing system now exposes a customizable handler for 405 Method Not Allowed responses, allowing applications to define specific behavior when a route exists but the HTTP method is unsupported. Also in this area: 1 commit (0 fixes) modifying (repo-wide).
FIO.Http, FIO.Sockets · low confidence
Improved error handling and connection management in FIO.Sockets and FIO.WebSockets
The FIO.Sockets and FIO.WebSockets libraries now provide more robust and typed error handling, replacing raw exception wrapping with specific error types like \CodecError\ and \Closed\ in WebSocket extensions. Connection lifecycle management has been refined: WebSocket clients and servers now properly dispose of resources and handle closing handshakes with bounded timeouts to prevent indefinite hangs. Additionally, the server socket accept loop now suppresses errors and includes a brief sleep to prevent tight-loop spinning during interruptions, while WebSocket server connections now expose the remote and local endpoints. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Benchmark suite cleanup, CLI flag expansion, and HTTP handler type safety.
src/FIO.WebSockets · low confidence · unverified
Refactored request body reading and simplified timeout middleware
The HTTP server now uses a unified, reusable function to read request bodies, which enforces maximum body size limits and properly handles truncated streams for both fixed-length and chunked requests. Additionally, the timeout middleware signature has been simplified by removing the explicit error handler argument, relying on the default timeout response behavior instead. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Improved HTTP route matching and server shutdown handling.
src/FIO.Http, src/FIO.Sockets · low confidence · unverified
Refined application lifecycle and new parallel combinators
The FIOApp lifecycle now distinguishes between application outcomes and shutdown hooks: a new \onOutcome\ hook runs after the main effect settles (including finalizers) to handle success, failure, or interruption results, while \onShutdown\ runs afterward for process-level cleanup. Interruption is now strictly reserved for explicit requests (Ctrl+C, SIGTERM, or \Stop()\), whereas defects or invalid arguments result in a fatal error. The runtime introduces \JoinFirst\ and \JoinAllFailFast\ primitives for parallel execution, and improves shutdown reliability by ensuring the effect context is tracked and interrupts are propagated correctly during unmounting. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Benchmark suite cleanup, CLI flag expansion, and HTTP handler type safety.
FIO, src/FIO · low confidence
Updated FIO examples with new SharedCounterApp and API simplifications
The examples directory now includes a new SharedCounterApp demonstrating atomic counter updates across parallel fibers using Ref. The FIOApp showcase (App example) has been refactored to use acquireReleaseWith for resource management instead of a custom shutdown hook, and several API calls (FIO.sleep, Timeout) no longer require the explicit 'id' parameter, simplifying the code. A new README.md has been added to document all runnable example projects. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Benchmark suite cleanup, CLI flag expansion, and HTTP handler type safety.
examples · low confidence · unverified
WebSocket server gains connection limits, shutdown timeouts, and improved error handling
The WebSocket server now supports configuring a maximum number of concurrent connections and a shutdown timeout that gracefully interrupts handlers before closing connections. The default configuration has changed: receive timeouts are now disabled by default, and a new \ShutdownTimeout\ of 10 seconds is applied. Error handling is more precise: JSON serialization failures and premature connection closures are now distinct error types (\CodecError\ and \Closed\) rather than generic errors, and the \accept\ function now properly rejects non-WebSocket requests with a 400 status code. Additionally, the \close\ and \abort\ functions now suppress errors during listener shutdown to prevent noise.
FIO.WebSockets · high confidence
Test coverage
Added test coverage for new concurrency primitives and HTTP routing features; Added tests for console input interruption and sequential reading behavior.
Dependencies
Update core and test dependencies; add Ref, JoinFirst, and ZipRace benchmarks
This release updates several key dependencies: FSharp.Core to 10.1.401, Expecto and Expecto.FsCheck to 11.1.0, FsCheck to 3.4.0, Microsoft.NET.Test.Sdk to 18.10.1, and YoloDev.Expecto.TestSdk to 0.16.1. The FIO library now includes a new Ref DSL component, with corresponding tests added for Ref, JoinFirst, and JoinAllFailFast. Benchmarking coverage has been expanded with new ZipRace benchmarks. Additionally, the packaging assets for FIO, FIO.Http, FIO.Sockets, and FIO.WebSockets have been updated to use a new logo file.
(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
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 72 → 71 (-0.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 84 → 80 (-3.5)
- Architecture 92 → 91 (-1.2)
- Maturity 65 → 65 (+0.2)
- Readiness 68 → 72 (+4.3)
- Security 84 → 74 (-10.2)
- Performance 94 → 91 (-2.1)
Resolved (24)
- Duplicated block (13–14 lines × 2) (src/FIO/DSL/Core.fs)
- Duplicated block (14 lines × 2) (src/FIO/DSL/Core.fs)
- Duplicated block (17 lines × 3) (src/FIO/Runtime/PollingRuntime.fs)
- Duplicated block (18 lines × 2) (examples/FIO.Examples.App/Program.fs)
- Duplicated block (18–19 lines × 3) (src/FIO/Runtime/PollingRuntime.fs)
- Duplicated block (19–22 lines × 2) (src/FIO/Runtime/PollingRuntime.fs)
- Duplicated block (21 lines × 2) (src/FIO/Runtime/PollingRuntime.fs)
- Duplicated block (59–61 lines × 2) (src/FIO/Runtime/PollingRuntime.fs)
- Duplicated block (7 lines × 4) (src/FIO/Runtime/DirectRuntime.fs)
- Duplicated block (71–78 lines × 2) (src/FIO/Runtime/PollingRuntime.fs)
- Duplicated block (8 lines × 2) (src/FIO/DSL/Extensions.fs)
- Hotspot: src/FIO/DSL/Core.fs (src/FIO/DSL/Core.fs)
- Hotspot: src/FIO/Runtime/PollingRuntime.fs (src/FIO/Runtime/PollingRuntime.fs)
- Hotspot: src/FIO/Runtime/SignalingRuntime.fs (src/FIO/Runtime/SignalingRuntime.fs)
- IL efficiency: 6 authored method(s) exceed the IL budget (src/FIO/Runtime/InterpreterCore.fs)
- Medium: security finding (details withheld)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (src/FIO/Runtime/DirectRuntime.fs)
- Outdated: FSharp.Core
- Outdated: FsCheck
- PollingRuntime.InterpretAsync (cognitive 61) (src/FIO/Runtime/PollingRuntime.fs)
- …and 4 more
New (9)
- Duplicated block (15 lines × 2) (examples/FIO.Examples.App/Program.fs)
- Duplicated block (5 lines × 2) (src/FIO/DSL/Extensions.fs)
- Duplicated block (6 lines × 2) (src/FIO/DSL/Extensions.fs)
- Duplicated block (6 lines × 2) (src/FIO/DSL/Factories.fs)
- Duplicated block (6 lines × 2) (src/FIO/Runtime/DirectRuntime.fs)
- FiberContext.RescheduleBlockingWorkItems (cognitive 17) (src/FIO/DSL/Core.fs)
- FileTooLong: FIO.WebSockets/WebSocket.fs (src/FIO.WebSockets/WebSocket.fs)
- High: security finding (details withheld)
- Scattered collaborators
Changes since last survey
- 7 commits — 6 feature/other, 1 fixes
By area
- (root) — 3 commits
- tests/FIO.Tests — 2 commits
- .github/workflows — 1 commit
- benchmarks/FIO.Benchmarks — 1 commit
Notable commits
- fix: Fix three timing-dependent soak tests (#88)
- change: Adopt Fantomas (#85)
- change: Build(deps): bump the actions group across 1 directory with 4 updates (#86)
- change: Clean-ups: blame-ignore file, PublicApiTests notes, FSharp.Core 11.0.101 (#89)
- change: Publish with NuGet trusted publishing (#84)
- change: Release 0.6.0-beta (#80)
- change: Skip the Fantomas reformat in git blame (#87)
Architecture
- Unchanged — 0 containers · 6 contexts · 5 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
fs-fio/fio 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 c9245c99de8a3f05ef352b87cc6e713b1c65d9f9 — 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.