Skip to content
CAI
Software that uses CAICheck a score

ionide/FSharp.Analyzers.SDK

57.7

Adequate · 15 November 2026

3.4k

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

Added F\# sample project demonstrating OptionAnalyzer warning

A new sample project (samples/MsBuildExample) has been added to demonstrate the behavior of the OptionAnalyzer. The included Program.fs file defines a simple F\# console application that intentionally triggers a warning from the analyzer by accessing the value of an Option type.

samples/MsBuildExample · high confidence

Initial release of the F\# Analyzers CLI tool

The \src/FSharp.Analyzers.Cli\ directory now contains the complete source code for the new command-line interface, enabling users to run F\# analyzers on projects and scripts. The tool supports analyzing \.fsproj\ files and \.fsx\ scripts, with options to pass MSBuild properties, filter files via globs, and remap analyzer severity levels. Output is available in a default console format or a GitHub Actions-compatible format, and results can be exported to a SARIF report file. The CLI includes robust error handling with specific exit codes for issues like missing analyzers, project load failures, or invalid arguments.

src/FSharp.Analyzers.Cli · high confidence

New 'upgrade-fsharp-analyzers' agent skill for F\# analyzer updates

A new agent skill has been added to help users upgrade the \fsharp-analyzers\ tool and associated analyzer packages (such as Ionide.Analyzers and G-Research.FSharp.Analyzers) to consistent versions. This skill addresses the specific challenge that analyzer packages do not declare their required \FSharp.Analyzers.SDK\ version as a NuGet dependency, which can cause tool failures if versions mismatch. The skill includes helper scripts (\sdk-from-source.sh\ and \sdk-version.fsx\) to resolve SDK dependencies from package source repositories or assembly metadata, allowing users to safely bump versions and review changes without modifying source code.

skills · high confidence

New AST and TAST walker infrastructure for analyzer authors

The SDK now provides \ASTCollecting\ and \TASTCollecting\ modules, introducing \SyntaxCollectorBase\ and \TypedTreeCollectorBase\ classes that allow analyzer authors to traverse the F\# syntax tree (AST) and typed tree (TAST) by overriding specific walk methods for nodes like expressions, types, and bindings. This new visitor pattern is complemented by updated client interfaces in \FSharp.Analyzers.SDK.Client\ that support filtering analyzers via \ExcludeInclude\ predicates and exposing analyzer metadata such as short descriptions and help URIs. Additionally, the SDK has migrated from Paket (\paket.references\, \paket.template\) to standard .NET package management.

src/FSharp.Analyzers.SDK · high confidence

New F\# analyzer testing SDK with binary log parsing and strict error handling

A new testing library for F\# analyzers has been introduced, providing utilities to parse compiler arguments from MSBuild binary logs and construct F\# project options or snapshots for analysis. The SDK enforces strict failure modes by throwing exceptions if the underlying build fails, if the binary log cannot be parsed, or if analyzers fail to load. It also introduces a custom \CompilerDiagnosticErrors\ exception to surface error-severity diagnostics and ensures consistent timestamping by using UTC for project load times.

FSharp.Analyzers.SDK.Testing · high confidence

New F\# analyzer testing utilities and exception types

The F\# analyzer SDK testing library now includes a new interface file defining helper functions for creating project options and snapshots from temporary classlib projects, supporting specific target frameworks and additional package references. It introduces a \CompilerDiagnosticErrors\ exception to handle compiler diagnostic failures and provides assertion helpers for validating warning messages in test scenarios, enabling more robust testing of F\# analyzers.

src/FSharp.Analyzers.SDK.Testing · high confidence

New Option.Value analyzer sample for detecting unsafe Option.Value usage

A new sample analyzer has been added to the OptionAnalyzer project that detects the use of the \Option.Value\ property on F\# \Option\ types. The analyzer walks the typed abstract syntax tree (TAST) and reports a warning (code OV001) whenever \Microsoft.FSharp.Core.FSharpOption\1.Value\` is accessed, helping users identify potential runtime exceptions from accessing None values. The sample is exposed via both Editor and CLI contexts, allowing it to be used in development environments and command-line analysis tools.

samples/OptionAnalyzer · high confidence

Behavioural changes

5 commits (0 fixes) modifying FSharp.Analyzers.Cli

A change to existing behaviour in FSharp.Analyzers.Cli — 5 commits, 3 files: “Type check scripts against the SDK reference assemblies”; “Report code that does not type check and release as 0.41.0”; “Allow glob patterns in --treat-as-\* switches”; and 2 more.

FSharp.Analyzers.Cli · medium confidence · unverified

Added sample demonstrating OptionAnalyzer warning

A new sample file, BadOptionUsage.fsx, has been added to the samples directory. It demonstrates a scenario where accessing the value of an Option type directly (using .Value) triggers a warning from the OptionAnalyzer, serving as an example of bad option usage patterns.

samples · high confidence

Modernized build infrastructure and developer tooling

The project has replaced the legacy FAKE-based build system with a new Fun.Build script and migrated from the classic .sln format to the new .slnx solution format. To ensure consistent code quality, Fantomas formatting is now enforced automatically during the build process via Directory.Build.targets, supported by a comprehensive .editorconfig and .fantomasignore. The repository also updated its .gitignore, added .gitattributes for proper line-ending handling, and switched the default branch reference from 'master' to 'main' in documentation and contributing guidelines.

(repo-wide) · high confidence

New ignore comment syntax and SDK client infrastructure

The SDK now supports a new \fsharpanalyzer:ignore-\*\ comment syntax (e.g., \ignore-line\, \ignore-file\, \ignore-region-start/end\) to control analyzer message suppression, replacing the previous block-comment-based ignore mechanism. Additionally, a new \FSharp.Analyzers.SDK.Client\ module has been introduced to handle analyzer loading, registration, and execution, exposing details like analyzer names and help URIs while managing the analysis context and result processing.

FSharp.Analyzers.SDK · high confidence

Test coverage

Added tests for CLI argument parsing, MSBuild property expansion, script loading, and severity mapping; Added unit tests for OptionAnalyzer ignore ranges and client loading.

Dependencies

Migrate to .NET 10 and centralize dependency management

The project has been retargeted from .NET Standard 2.0 to .NET 10.0 for the SDK, CLI, and test projects, dropping support for older runtimes. To support this upgrade, the build system has migrated from Paket to native .NET Central Package Management (via Directory.Packages.props), removing the legacy paket.dependencies and paket.lock files. Key dependencies have been updated to their latest versions, including FSharp.Core to 10.1.400, FSharp.Compiler.Service to 43.12.400, and Microsoft.Extensions.Logging.Abstractions to 10.0.11.

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

Lenses

  • Code Health 91 → 89 (-1.6)
  • Architecture 67 → 67 (-0.0)
  • Maturity 51 → 52 (+0.6)
  • Readiness 68 → 51 (-16.5)
  • Security 72 → 68 (-4.0)
  • Performance 100 → 100 (+0.0)

Resolved (7)

  • Duplicated block (28 lines × 2) (src/FSharp.Analyzers.SDK/FSharp.Analyzers.SDK.fs)
  • Hotspot: src/FSharp.Analyzers.Cli/Analysis.fs (src/FSharp.Analyzers.Cli/Analysis.fs)
  • Hotspot: src/FSharp.Analyzers.Cli/Arguments.fs (src/FSharp.Analyzers.Cli/Arguments.fs)
  • IL efficiency: 8 authored method(s) exceed the IL budget (src/FSharp.Analyzers.SDK/ASTCollecting.fs)
  • No ADRs found
  • Off-boarding risk: anonymized user #1
  • Outdated: Ionide.ProjInfo.ProjectSystem

New (10)

  • Low coverage: src/FSharp.Analyzers.Cli/CustomLogging.fs (src/FSharp.Analyzers.Cli/CustomLogging.fs)
  • Low coverage: src/FSharp.Analyzers.Cli/MsBuildProperties.fs (src/FSharp.Analyzers.Cli/MsBuildProperties.fs)
  • Low coverage: src/FSharp.Analyzers.Cli/Output.fs (src/FSharp.Analyzers.Cli/Output.fs)
  • Low coverage: src/FSharp.Analyzers.Cli/Program.fs (src/FSharp.Analyzers.Cli/Program.fs)
  • Low coverage: src/FSharp.Analyzers.Cli/ProjectLoading.fs (src/FSharp.Analyzers.Cli/ProjectLoading.fs)
  • Low coverage: src/FSharp.Analyzers.Cli/Result.fs (src/FSharp.Analyzers.Cli/Result.fs)
  • Low coverage: src/FSharp.Analyzers.SDK/ASTCollecting.fs (src/FSharp.Analyzers.SDK/ASTCollecting.fs)
  • Low coverage: src/FSharp.Analyzers.SDK/TASTCollecting.fs (src/FSharp.Analyzers.SDK/TASTCollecting.fs)
  • No ADRs found (src/FSharp.Analyzers.Cli/FSharp.Analyzers.Cli.fsproj)
  • Off-boarding risk: anonymized user #1

Changes since last survey

  • 10 commits — 10 feature/other, 0 fixes

By area

  • (repo) — 3 commits
  • (root) — 3 commits
  • src/FSharp.Analyzers.SDK — 3 commits
  • .config/dotnet-tools.json — 1 commit

Notable commits

  • change: Bump Ionide.ProjInfo.ProjectSystem from 0.75.0 to 0.75.3
  • change: Bump fantomas from 8.1.0 to 8.1.1
  • change: Convert the typed tree once per file and share it between analyzers
  • change: Force each top-level body once instead of recursing over the tree
  • change: Keep materializing the siblings of a node that fails to convert
  • change: Materialize every expression of the shared tree and drop the CLI pre-step
  • change: Merge pull request #358 from ionide/dependabot/nuget/Ionide.ProjInfo.ProjectSystem-0.75.3
  • change: Merge pull request #359 from ionide/dependabot/nuget/dot-config/fantomas-8.1.1
  • change: Merge pull request #360 from 1eyewonder/share-typed-tree-per-file
  • change: changelog for v0.41.1

Architecture

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

ionide/FSharp.Analyzers.SDK 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 582617f555e5a12ad8c056c5682da278691e7adf — 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.