fix: extract API sidebar titles from H1 headings in docs workflow

The inline frontmatter loop was using filename-based titles, producing
lowercase names with -N suffixes for generics. Now extracts the title
from the H1 heading in each generated markdown file, matching the fix
in generate-api-docs.sh.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: MrBogomips

.github/workflows/docs.yml

@@ -64,11 +64,25 @@ jobs:
           for file in docs/docs/api/*.md; do
             if [ -f "$file" ]; then
               filename=$(basename "$file" .md)
-              title="${filename#bogoware.monads.}"
+              if [ "$filename" = "index" ]; then
+                title="API Reference"
+                position=1
+              else
+                position=99
+                # Extract title from H1 heading in the generated markdown
+                h1_line=$(grep -m1 "^# " "$file" || true)
+                if [ -n "$h1_line" ]; then
+                  title="${h1_line#\# }"
+                  title="${title//&lt;/<}"
+                  title="${title//&gt;/>}"
+                else
+                  title="${filename#bogoware.monads.}"
+                fi
+              fi
               temp_file=$(mktemp)
               echo "---" > "$temp_file"
               echo "title: \"$title\"" >> "$temp_file"
-              echo "sidebar_position: 99" >> "$temp_file"
+              echo "sidebar_position: $position" >> "$temp_file"
               echo "---" >> "$temp_file"
               echo "" >> "$temp_file"
               cat "$file" >> "$temp_file"