Sync llms-full.txt as a static duplicate (#62864)

Co-authored-by: Natalie Harris <natalierharris@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: natalierharris

.github/workflows/sync-llms-txt.yml

@@ -1,11 +1,12 @@
 name: Sync llms.txt
 
-# **What it does**: Generates docs.github.com/llms.txt and github.com/llms.txt
-#   from the page catalog and popularity data, then opens PRs to update both.
+# **What it does**: Generates docs.github.com/llms.txt, github.com/llms.txt, and
+#   github.com/llms-full.txt from the page catalog and popularity data, then
+#   opens PRs to update them.
 # **Why we have it**: Agents discover docs through llms.txt; the page list keeps
 #   pace with what's actually popular without writers updating it by hand.
 # **Who does it impact**: Docs consumers via agents, and anyone landing on
-#   github.com/llms.txt or docs.github.com/llms.txt.
+#   github.com/llms.txt, github.com/llms-full.txt, or docs.github.com/llms.txt.
 
 on:
   workflow_dispatch:
@@ -134,24 +135,34 @@ jobs:
             --draft \
             --label "llm-generated"
 
-      # ---------- PR to github/github: update public/llms.txt ----------
+      # ---------- PR to github/github: update public/llms*.txt ----------
 
-      - name: Fetch current public/llms.txt from github/github
+      - name: Fetch current public llms files from github/github
         id: fetch_monolith
         env:
           GH_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}
         run: |
-          if gh api repos/github/github/contents/public/llms.txt \
-              --jq '.content' 2>/dev/null | base64 -d > /tmp/monolith-current.txt; then
-            echo "Fetched current ($(wc -l < /tmp/monolith-current.txt) lines)"
-          else
-            rm -f /tmp/monolith-current.txt
-          fi
+          fetch_current() {
+            local target_file="$1"
+            local output_file="$2"
+            if gh api -H "Accept: application/vnd.github.raw" \
+                "repos/github/github/contents/$target_file" \
+                > "$output_file" 2>/dev/null; then
+              echo "Fetched current $target_file"
+            else
+              rm -f "$output_file"
+            fi
+          }
+          fetch_current public/llms.txt /tmp/monolith-current-llms.txt
+          fetch_current public/llms-full.txt /tmp/monolith-current-llms-full.txt
 
-      - name: Diff monolith llms.txt
+      - name: Diff monolith llms files
         id: diff_monolith
         run: |
-          if [ -f /tmp/monolith-current.txt ] && diff -q /tmp/monolith-llms.txt /tmp/monolith-current.txt > /dev/null 2>&1; then
+          if [ -f /tmp/monolith-current-llms.txt ] && \
+              diff -q /tmp/monolith-llms.txt /tmp/monolith-current-llms.txt > /dev/null 2>&1 && \
+              [ -f /tmp/monolith-current-llms-full.txt ] && \
+              diff -q /tmp/monolith-llms.txt /tmp/monolith-current-llms-full.txt > /dev/null 2>&1; then
             echo "No monolith changes, skipping"
             echo "changed=false" >> "$GITHUB_OUTPUT"
           else
@@ -177,49 +188,56 @@ jobs:
             echo "Created branch $BRANCH from $DEFAULT_BRANCH at $BASE_SHA"
           fi
 
-      - name: Commit monolith llms.txt to github/github
+      - name: Commit monolith llms files to github/github
         if: steps.diff_monolith.outputs.changed == 'true'
         env:
           GH_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}
         run: |
           REPO="github/github"
           CONTENT=$(base64 -w 0 /tmp/monolith-llms.txt)
 
-          if EXISTING_SHA=$(gh api "repos/$REPO/contents/public/llms.txt?ref=$BRANCH" \
-            --jq '.sha' 2>/dev/null); then
-            echo "Existing file SHA: $EXISTING_SHA"
-          else
-            EXISTING_SHA=""
-          fi
+          sync_file() {
+            local target_file="$1"
+            local branch_copy="/tmp/monolith-branch-$(basename "$target_file")"
+            if gh api -H "Accept: application/vnd.github.raw" \
+                "repos/$REPO/contents/$target_file?ref=$BRANCH" \
+                > "$branch_copy" 2>/dev/null && \
+                diff -q /tmp/monolith-llms.txt "$branch_copy" > /dev/null 2>&1; then
+              echo "$target_file is already current on $BRANCH"
+              return
+            fi
 
-          COMMIT_ARGS=(-f "message=Sync llms.txt from docs.github.com"
-            -f "content=$CONTENT"
-            -f "branch=$BRANCH")
-          if [ -n "$EXISTING_SHA" ]; then
-            COMMIT_ARGS+=(-f "sha=$EXISTING_SHA")
-          fi
-          gh api "repos/$REPO/contents/public/llms.txt" \
-            --method PUT \
-            "${COMMIT_ARGS[@]}" --jq '.commit.sha'
+            local existing_sha
+            existing_sha=$(gh api "repos/$REPO/contents/$target_file?ref=$BRANCH" \
+              --jq '.sha' 2>/dev/null || true)
+            local commit_args=(-f "message=Sync $(basename "$target_file") from docs.github.com"
+              -f "content=$CONTENT"
+              -f "branch=$BRANCH")
+            if [ -n "$existing_sha" ]; then
+              commit_args+=(-f "sha=$existing_sha")
+            fi
+            gh api "repos/$REPO/contents/$target_file" \
+              --method PUT \
+              "${commit_args[@]}" --jq '.commit.sha'
+          }
+
+          sync_file public/llms.txt
+          sync_file public/llms-full.txt
 
       - name: Create or update github/github PR
         if: steps.diff_monolith.outputs.changed == 'true'
         env:
           GH_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}
         run: |
           REPO="github/github"
-          if EXISTING_PR=$(gh pr list --repo "$REPO" --head "$BRANCH" \
-            --json number --jq '.[0].number' 2>/dev/null) && [ -n "$EXISTING_PR" ]; then
-            echo "Monolith PR #$EXISTING_PR already exists, updated with new commit"
-            exit 0
-          fi
-
           RUN_URL="${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}"
           DEFAULT_BRANCH=$(gh api "repos/$REPO" --jq '.default_branch')
 
           PR_BODY="The [sync-llms-txt workflow]($RUN_URL) generated this PR.
 
-          Updates \`public/llms.txt\`, served at https://github.com/llms.txt. Built in docs-internal from the page catalog and popularity data using \`data/llms-txt/config-default.yml\` + \`config-monolith.yml\`.
+          Updates the static generated files \`public/llms.txt\` and \`public/llms-full.txt\`, served at https://github.com/llms.txt and https://github.com/llms-full.txt. Both are built in docs-internal from the page catalog and popularity data using \`data/llms-txt/config-default.yml\` + \`config-monolith.yml\`.
+
+          Initially, \`llms-full.txt\` is intentionally an exact duplicate of \`llms.txt\`.
 
           No feature flags. Static file in \`public/\`, no code changes.
 
@@ -233,9 +251,19 @@ jobs:
           pull_request_template_version=2
           -->"
 
+          if EXISTING_PR=$(gh pr list --repo "$REPO" --head "$BRANCH" \
+            --json number --jq '.[0].number' 2>/dev/null) && [ -n "$EXISTING_PR" ]; then
+            gh api "repos/$REPO/pulls/$EXISTING_PR" \
+              --method PATCH \
+              -f title="Sync llms.txt and llms-full.txt from docs.github.com" \
+              -f body="$PR_BODY" > /dev/null
+            echo "Monolith PR #$EXISTING_PR already exists, updated with new commit"
+            exit 0
+          fi
+
           gh pr create \
             --repo "$REPO" \
-            --title "Sync llms.txt from docs.github.com" \
+            --title "Sync llms.txt and llms-full.txt from docs.github.com" \
             --body "$PR_BODY" \
             --head "$BRANCH" \
             --base "$DEFAULT_BRANCH" \