Add GitHub Action to generate LLM-optimized documentation

.github/workflows/D-deploy-to-gh-pages.yml

@@ -48,6 +48,42 @@ jobs:
 
 
 
+      ##############################
+      # Generate LLM-optimized docs (llmstxt.org standard)
+      # Uses build directory discovery since keridoc uses autogenerated sidebars
+      - name: Generate LLM documentation
+        uses: osodevops/docusaurus-llm-docs@v1
+        id: llm-docs
+        with:
+          build-dir: './build'
+          output-dir: './build/llm-docs'
+          base-url: 'https://weboftrust.github.io/keridoc'
+          product-name: 'KERIDoc'
+          tagline: 'KERI Suite Documentation'
+          inject-sidebar: 'false'
+          sidebar-path: './sidebars-nonexistent.js'
+
+      - name: Copy LLM docs to build root and repo
+        run: |
+          cp ${{ steps.llm-docs.outputs.llms-txt-path }} ./build/llms.txt
+          cp ${{ steps.llm-docs.outputs.llms-full-txt-path }} ./build/llms-full.txt
+          cp ${{ steps.llm-docs.outputs.markdown-zip-path }} ./build/markdown.zip
+          mkdir -p ./llm-docs
+          cp ${{ steps.llm-docs.outputs.llms-txt-path }} ./llm-docs/llms.txt
+          cp ${{ steps.llm-docs.outputs.llms-full-txt-path }} ./llm-docs/llms-full.txt
+          cp ${{ steps.llm-docs.outputs.markdown-zip-path }} ./llm-docs/markdown.zip
+
+      - name: Commit LLM docs to repo
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add llm-docs/
+          git diff --staged --quiet && echo "No changes to commit" || git commit -m "Update LLM-optimized documentation [automated]"
+          git push
+      ##############################
+
+
+
       ##############################
       # Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
       - name: Deploy to GitHub Pages

.github/workflows/generate-llm-docs.yml

@@ -0,0 +1,60 @@
+name: Generate LLM Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'docusaurus.config.js'
+      - 'sidebars.js'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  generate-llm-docs:
+    name: Build site and generate LLM-optimized docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build website
+        run: npm run build
+
+      - name: Generate LLM documentation
+        uses: osodevops/docusaurus-llm-docs@v1
+        id: llm-docs
+        with:
+          build-dir: './build'
+          output-dir: './build/llm-docs'
+          base-url: 'https://weboftrust.github.io/keridoc'
+          product-name: 'KERIDoc'
+          tagline: 'KERI Suite Documentation'
+          inject-sidebar: 'false'
+          sidebar-path: './sidebars-nonexistent.js'
+
+      - name: Copy LLM docs to build output
+        run: |
+          cp ${{ steps.llm-docs.outputs.llms-txt-path }} ./build/llms.txt
+          cp ${{ steps.llm-docs.outputs.llms-full-txt-path }} ./build/llms-full.txt
+          cp ${{ steps.llm-docs.outputs.markdown-zip-path }} ./build/markdown.zip
+
+      - name: Upload LLM docs as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: llm-docs
+          path: |
+            ./build/llms.txt
+            ./build/llms-full.txt
+            ./build/markdown.zip
+          retention-days: 30