ci: harden Fern devnotes publishing

Author: andreatgretel

.github/workflows/build-fern-docs.yml

@@ -167,7 +167,7 @@ jobs:
       contents: write
     with:
       use_cache: ${{ github.event_name == 'workflow_dispatch' && inputs.use_cache || false }}
-      checkout_ref: ${{ needs.resolve-release.outputs.prepare_release_docs == '1' && needs.resolve-release.outputs.source_ref || '' }}
+      checkout_ref: ${{ needs.resolve-release.outputs.prepare_release_docs == '1' && needs.resolve-release.outputs.source_ref || needs.resolve-release.outputs.release_tag }}
     secrets: inherit
 
   publish:

.github/workflows/docs-preview.yml

@@ -55,6 +55,13 @@ jobs:
       - name: Build docs
         run: .venv/bin/mkdocs build
 
+      - name: Verify published Fern archive exists
+        run: |
+          if ! git ls-remote --exit-code --heads origin "$FERN_PUBLISHED_BRANCH" >/dev/null 2>&1; then
+            echo "::error::$FERN_PUBLISHED_BRANCH does not exist. Publish a Fern release snapshot first."
+            exit 1
+          fi
+
       - name: Checkout published Fern archive
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:

.github/workflows/publish-fern-devnotes.yml

@@ -4,12 +4,16 @@ on:
   push:
     branches: [main]
     paths:
-      - "fern/assets/devnotes/**"
+      - "fern/assets/**"
       - "fern/components/Authors.tsx"
       - "fern/components/BlogCard.tsx"
+      - "fern/components/MetricsTable.tsx"
+      - "fern/components/TrajectoryViewer.tsx"
       - "fern/components/devnotes/**"
       - "fern/styles/authors.css"
       - "fern/styles/blog-card.css"
+      - "fern/styles/metrics-table.css"
+      - "fern/styles/trajectory-viewer.css"
       - "fern/versions/latest.yml"
       - "fern/versions/latest/pages/devnotes/**"
   workflow_dispatch:

fern/scripts/fern-published-branch.py

@@ -30,12 +30,16 @@
     "site",
 }
 FERN_DEVNOTE_SUPPORT_PATHS = [
-    "fern/assets/devnotes",
+    "fern/assets",
     "fern/components/Authors.tsx",
     "fern/components/BlogCard.tsx",
+    "fern/components/MetricsTable.tsx",
+    "fern/components/TrajectoryViewer.tsx",
     "fern/components/devnotes",
     "fern/styles/authors.css",
     "fern/styles/blog-card.css",
+    "fern/styles/metrics-table.css",
+    "fern/styles/trajectory-viewer.css",
 ]