From ce60e5f5e088fb558bcb44ad73c1967e9f3bbd82 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Feb 2026 03:49:11 +0000
Subject: [PATCH 1/4] Initial plan


From 5adf0dc925edab3bdca978348d5e6452c0370f0a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Feb 2026 03:53:06 +0000
Subject: [PATCH 2/4] Add Fern docs workflows for PR preview and publish on
 main

Co-authored-by: hawkeyexl <5209367+hawkeyexl@users.noreply.github.com>
---
 .github/workflows/preview-docs.yml | 39 ++++++++++++++++++++++++++++++
 .github/workflows/publish-docs.yml | 24 ++++++++++++++++++
 2 files changed, 63 insertions(+)
 create mode 100644 .github/workflows/preview-docs.yml
 create mode 100644 .github/workflows/publish-docs.yml

diff --git a/.github/workflows/preview-docs.yml b/.github/workflows/preview-docs.yml
new file mode 100644
index 0000000..06d973f
--- /dev/null
+++ b/.github/workflows/preview-docs.yml
@@ -0,0 +1,39 @@
+name: Preview docs
+
+on: pull_request
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 #v6.0.1
+
+      - name: Set up Fern CLI
+        uses: fern-api/setup-fern-cli@d07601425e9c9ede8745d71ca75c4c462d98755d #v1
+
+      - name: Generate preview URL
+        id: generate-docs
+        env:
+          FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
+        run: |
+          OUTPUT=$(fern generate --docs --preview 2>&1) || true
+          echo "$OUTPUT"
+          URL=$(echo "$OUTPUT" | grep -oP 'Published docs to \K.*(?= \()')
+          if [ -z "$URL" ]; then
+            echo "preview_url=" >> "$GITHUB_OUTPUT"
+            echo "⚠️ Failed to generate docs preview. Check the workflow logs for details." > preview_url.txt
+          else
+            echo "preview_url=$URL" >> "$GITHUB_OUTPUT"
+            echo "🌿 Preview your docs: $URL" > preview_url.txt
+          fi
+
+      - name: Comment URL in PR
+        uses: thollander/actions-comment-pull-request@1d3973dc4b8e1399c0620d3f2b1aa5e795465308 #v2.4.3
+        with:
+          filePath: preview_url.txt
+          comment_tag: preview-docs
+          mode: upsert
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
new file mode 100644
index 0000000..b7baf86
--- /dev/null
+++ b/.github/workflows/publish-docs.yml
@@ -0,0 +1,24 @@
+name: Publish docs
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    if: github.run_number > 1
+    permissions:
+      contents: read
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 #v6.0.1
+
+      - name: Set up Fern CLI
+        uses: fern-api/setup-fern-cli@d07601425e9c9ede8745d71ca75c4c462d98755d #v1
+
+      - name: Publish docs
+        env:
+          FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
+        run: fern generate --docs --log-level debug

From 6e47248a7b2470c196b726db6c94deaa4884c1e0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Feb 2026 13:32:29 +0000
Subject: [PATCH 3/4] Add workflow_dispatch trigger to publish and preview
 workflows

Co-authored-by: hawkeyexl <5209367+hawkeyexl@users.noreply.github.com>
---
 .github/workflows/preview-docs.yml | 4 +++-
 .github/workflows/publish-docs.yml | 1 +
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/preview-docs.yml b/.github/workflows/preview-docs.yml
index 06d973f..5c6e281 100644
--- a/.github/workflows/preview-docs.yml
+++ b/.github/workflows/preview-docs.yml
@@ -1,6 +1,8 @@
 name: Preview docs
 
-on: pull_request
+on:
+  pull_request:
+  workflow_dispatch:
 
 jobs:
   preview:
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
index b7baf86..d988444 100644
--- a/.github/workflows/publish-docs.yml
+++ b/.github/workflows/publish-docs.yml
@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+  workflow_dispatch:
 
 jobs:
   publish:

From ac16fc74596bef7324983c93fb372ecdcb9ff8ee Mon Sep 17 00:00:00 2001
From: hawkeyexl <hawkeyexl@gmail.com>
Date: Fri, 27 Feb 2026 05:54:24 -0800
Subject: [PATCH 4/4] update workflows

---
 .github/workflows/preview-docs.yml | 1 +
 .github/workflows/publish-docs.yml | 1 -
 .gitignore                         | 5 ++++-
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/preview-docs.yml b/.github/workflows/preview-docs.yml
index 5c6e281..465b4ff 100644
--- a/.github/workflows/preview-docs.yml
+++ b/.github/workflows/preview-docs.yml
@@ -34,6 +34,7 @@ jobs:
           fi
 
       - name: Comment URL in PR
+        if: github.event_name == 'pull_request'
         uses: thollander/actions-comment-pull-request@1d3973dc4b8e1399c0620d3f2b1aa5e795465308 #v2.4.3
         with:
           filePath: preview_url.txt
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
index d988444..fbf55a2 100644
--- a/.github/workflows/publish-docs.yml
+++ b/.github/workflows/publish-docs.yml
@@ -9,7 +9,6 @@ on:
 jobs:
   publish:
     runs-on: ubuntu-latest
-    if: github.run_number > 1
     permissions:
       contents: read
     steps:
diff --git a/.gitignore b/.gitignore
index f67c938..f6da19c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -45,4 +45,7 @@ pids
 
 # Temporary folders
 tmp/
-temp/
\ No newline at end of file
+temp/
+
+# Local files
+*.local.json
\ No newline at end of file