feat(docs): generate llms-full.txt method reference from the OpenAPI spec

Per-domain method sections in docs/llms-full.txt are now generated by
scripts/sync-docs.ts (BEGIN/END:METHODS markers): every call rendered from its
operationId, with request examples built from the spec example fields. The
multi-language note is generated too (BEGIN/END:LANGS) so it no longer drifts.
The curated intro and the Error Handling, Advanced and Links tail are preserved.

Adds the previously missing Human Design and Forecast domains. Extends the
docs-drift guard in lefthook.yml and ci.yml to cover docs/llms-full.txt. The
OpenAPI spec is now the single source of truth for the SDK docs.

Author: ph33nx

.github/workflows/ci.yml

@@ -37,8 +37,8 @@ jobs:
       - name: Docs drift check
         run: |
           bun run docs:sync
-          git diff --exit-code -- README.md AGENTS.md \
-            || { echo 'docs drift: commit the regenerated README.md/AGENTS.md'; exit 1; }
+          git diff --exit-code -- README.md AGENTS.md docs/llms-full.txt \
+            || { echo 'docs drift: commit the regenerated README.md/AGENTS.md/llms-full.txt'; exit 1; }
 
       - name: Test
         run: bun run test

AGENTS.md

@@ -45,6 +45,8 @@ Type `roxy.` to see all available namespaces. Type `roxy.{domain}.` to see every
 | `roxy.vedicAstrology` | 43 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
 | `roxy.numerology` | 16 | Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers |
 | `roxy.tarot` | 10 | Production-ready tarot card reading API + hosted MCP for AI agents and developers |
+| `roxy.humanDesign` | 10 | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |
+| `roxy.forecast` | 3 | Merge upcoming transit aspects, sign ingresses, retrograde stations, Vimshottari dasha changes, and biorhythm critica... |
 | `roxy.biorhythm` | 6 | The most complete biorhythm API + remote MCP for AI agents and developers |
 | `roxy.iching` | 9 | I-Ching oracle API + hosted MCP for AI agents and developers |
 | `roxy.crystals` | 12 | Production-ready crystal healing API + hosted MCP for AI agents and developers |

README.md

@@ -89,6 +89,8 @@ const { latitude, longitude, timezone } = data.cities[0];
 | `roxy.vedicAstrology` | 43 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
 | `roxy.numerology` | 16 | Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers |
 | `roxy.tarot` | 10 | Production-ready tarot card reading API + hosted MCP for AI agents and developers |
+| `roxy.humanDesign` | 10 | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |
+| `roxy.forecast` | 3 | Merge upcoming transit aspects, sign ingresses, retrograde stations, Vimshottari dasha changes, and biorhythm critica... |
 | `roxy.biorhythm` | 6 | The most complete biorhythm API + remote MCP for AI agents and developers |
 | `roxy.iching` | 9 | I-Ching oracle API + hosted MCP for AI agents and developers |
 | `roxy.crystals` | 12 | Production-ready crystal healing API + hosted MCP for AI agents and developers |