fsprojects/FSharp.Data.JsonSchema

This system is an F\# library that generates JSON Schema and OpenAPI documentation from F\# type definitions. It provides core analysis infrastructure for complex types like discriminated unions and recursive structures, with adapters to output schemas via NJsonSchema and ASP.NET Core OpenAPI middleware. The project has been restructured into modular packages to improve maintainability and includes comprehensive testing for schema accuracy and serialization roundtrips.

Adds a new implementation layer in \src/FSharp.Data.JsonSchema.NJsonSchema\ that bridges the core schema analysis with the NJsonSchema library. This includes \NJsonSchemaTranslator.fs\ to convert internal schema nodes into NJsonSchema objects (handling references, primitives, and nullable types), \JsonSchema.fs\ containing obsolete schema processors for legacy F\# type handling (options, single-case discriminated unions, and multi-case unions), and \Serializer.fs\ which provides a unified API for serializing and deserializing F\# types using System.Text.Json with specific F\#-aware options (such as union tagging and option unwrapping). The module depends on NJsonSchema, FSharp.Core, and FSharp.SystemTextJson.

src/FSharp.Data.JsonSchema.NJsonSchema · high confidence

This change establishes a structured Spec-Driven Development workflow by adding a project constitution, a suite of Bash automation scripts, and Markdown templates for feature specifications, implementation plans, and task lists. The new scripts in \.specify/scripts/bash/\ (including \check-prerequisites\, \create-new-feature\, \setup-plan\, and \update-agent-context\) automate the creation of feature branches, generation of implementation plans from templates, and synchronization of AI agent context files. The added templates (\spec-template\, \plan-template\, \tasks-template\, \checklist-template\, \agent-file-template\) define the required structure for feature documentation, while the constitution file sets project standards for API design, dependency management, and testing.

.specify · high confidence

Added the core library files (SchemaAnalyzer.fs, SchemaGeneratorConfig.fs, SchemaNode.fs) that define the intermediate representation for JSON schemas and the logic to analyze F\# types. This includes support for discriminated unions (with internal, adjacent, external, and untagged encoding styles), anonymous records, Choice types, option types, and various collection types, along with configuration options for naming policies, discriminator properties, and field requirements.

src/FSharp.Data.JsonSchema.Core · high confidence

This update addresses three security vulnerabilities in transitive dependencies by pinning specific versions: System.Text.Json is pinned to 6.0.10 for netcoreapp3.1 and 8.0.6 for other targets to mitigate [GHSA redacted] (denial of service in JsonSerializer); Newtonsoft.Json is pinned to 13.0.3 to address [GHSA redacted]; and Microsoft.OpenApi is pinned to 2.9.0 for net10.0 to prevent stack overflow parsing circular schema refs ([GHSA redacted]). Additionally, the library has been restructured into separate packages (Core, NJsonSchema, OpenApi) with the original package marked as deprecated, and FSharp.SystemTextJson is updated to version 1.1.23.

(dependencies) · high confidence

The FSharp.Data.JsonSchema package has been renamed to FSharp.Data.JsonSchema.NJsonSchema. A new compatibility shim has been introduced in the original package location that marks the module as obsolete and directs users to update their package references to the new name. The original package will not receive updates beyond version 3.0.0.

src/FSharp.Data.JsonSchema · high confidence

This release addresses several critical issues in the OpenAPI schema generation for F\# types. Discriminated unions and self-recursive types no longer cause \InvalidOperationException\ or generate dangling component references on .NET 10; instead, component schemas are correctly registered in the live \OpenApiDocument\ with unique, qualified IDs (e.g., \TreeNode.Leaf\) to prevent collisions. Format-annotated primitives like \DateTime\ and \Guid\ are now inlined directly into the schema rather than creating unnecessary \$ref\ components. Additionally, the \Microsoft.OpenApi\ dependency for .NET 10 is pinned to version 2.9.0 to address security vulnerabilities.

(repo-wide) · high confidence

The F\# Data JsonSchema library now correctly generates OpenAPI schemas for F\# records and unions when running on .NET 10. This update resolves issues where component schemas were not properly registered in the live OpenAPI document, leading to dangling references and missing definitions. It also inlines format-annotated primitives to prevent unnecessary component clutter and ensures distinct component IDs for types with similar case names, improving the accuracy and completeness of the generated API documentation.

src/FSharp.Data.JsonSchema.OpenApi · high confidence

Added comprehensive test suite for F\# JSON schema generation and serialization; Added end-to-end and integration tests for OpenAPI schema generation; Added specification and design contracts for the Core Extraction and Multi-Target Architecture feature.

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 61 → 62 (+0.8)
• Rubric changed (rubric-2026.09.15 → rubric-2026.10.1) — scores are not directly comparable.

• Code Health 58 → 58 (+0.0)
• Architecture 66 → 78 (+12.3)
• Maturity 65 → 65 (-0.1)
• Readiness 58 → 58 (+0.0)
• Security 83 → 80 (-3.3)

• Documentation: contradicts the code (docs/superpowers/plans/2026-07-25-openapi-dangling-schema-ref-fix.md)

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

fsprojects/FSharp.Data.JsonSchema 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.