[Repo Assist] Add (*** include-toc ***) directive for inline table of contents in literate F# scripts

[github-actions]

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

Closes #163

Summary

Implements the long-requested in-page table of contents directive for literate F# scripts (.fsx files).

Usage

In any literate .fsx file, place one of these commands where you want the TOC to appear:

(*** include-toc ***)        (* list all headings up to depth 3 (default) *)
(*** include-toc:2 ***)      (* list only H1 and H2 headings *)
(*** include-toc:1 ***)      (* list only H1 headings *)

The directive generates an unordered list of hyperlinks pointing to the heading anchors in the rendered HTML. It requires generateAnchors = true (the default in fsdocs build).

Example

(**
# My Document

(*** include-toc:2 ***)

## Section One

Some content.

## Section Two

More content.
*)

Renders the TOC as links to #Section-One and #Section-Two.

Implementation

• Document.fs: New TableOfContents of maxDepth: int * paragraphOptions: LiterateParagraphOptions case on LiterateParagraph.
• ParseScript.fs: Handles (*** include-toc ***) and (*** include-toc:N ***) commands in transformBlocks, defaulting depth to 3.
• Transformations.fs: New generateTableOfContents function that collects all Heading nodes, computes anchor names using the same algorithm as HtmlFormatting.formatAnchor (including UniqueNameGenerator simulation for duplicate headings), and replaces each TableOfContents paragraph with a ListBlock of DirectLink spans.
• Formatting.fs: generateTableOfContents is called as the first step in transformDocument, before replaceLiterateParagraphs.

Test Status

• Build: ✅ succeeded (0 warnings, 0 errors)
• Tests: ✅ 116/116 passed (FSharp.Literate.Tests)

Generated by Repo Assist for issue #163

To install this agentic workflow, run

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