[Repo Assist] Add ApiDocParameter and ApiDocReturnInfo named record types

[github-actions]

🤖 This PR was created by Repo Assist, an automated AI assistant.

Closes #735

Root Cause

ApiDocMember.Parameters returned a list<{| ParameterSymbol: ...; ParameterNameText: string; ParameterType: ApiDocHtml; ParameterDocs: ApiDocHtml option |}> and ApiDocMember.ReturnInfo returned an anonymous record {| ReturnType: ...; ReturnDocs: ... |}. Anonymous records from different assemblies are not structurally compatible in F#, making it impossible for external consumers to pass these values to their own functions without pre-processing.

Fix

Added two named record types:

type ApiDocParameter =
    { ParameterSymbol: Choice(FSharpParameter, FSharpField)
      ParameterNameText: string
      ParameterType: ApiDocHtml
      ParameterDocs: ApiDocHtml option }

type ApiDocReturnInfo =
    { ReturnType: (FSharpType * ApiDocHtml) option
      ReturnDocs: ApiDocHtml option }

ApiDocMember.Parameters now returns ApiDocParameter list and ApiDocMember.ReturnInfo returns ApiDocReturnInfo.

Backwards Compatibility

All field names are identical to the anonymous record fields, so existing code using .ParameterNameText, .ParameterType, .ParameterDocs, .ReturnType, .ReturnDocs continues to work without modification. The change is additive from a usage perspective (named types are strictly more usable than anonymous records).

Test Status

• Build: ✅ succeeded (0 warnings, 0 errors)
• Tests: ✅ 76/76 passed, 4 skipped (pre-existing)
• Formatting: ✅ Fantomas applied

Generated by Repo Assist for issue #735

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@da02dddebe71d9a937665abdcd1f5214dab852a7

[dsyme]

/repo-assist please update README

[github-actions]

Commit pushed: 5934619

Generated by Repo Assist

[github-actions]

🤖 This is an automated response from Repo Assist.

I've updated the docs as requested. Added a new "Working with API member parameters and return information" subsection to docs/apidocs.fsx under the "Building library documentation programmatically" section (da9c695).

The new section:

• Explains that ApiDocMember.Parameters returns ApiDocParameter list and ApiDocMember.ReturnInfo returns ApiDocReturnInfo
• Shows a traversal example using ApiDocs.GenerateModel
• Demonstrates defining user functions that accept these named types directly (the main motivation from issue Is it possible to expose the ApiDocMember.Parameters using a "real" record? #735)

Generated by Repo Assist for issue #1066 · ◷

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/repo-assist.md@10f087607af87e4e89439161f1e5d4724235f396