[pull] main from fern-api:main

.github/workflows/ci.yml

@@ -111,7 +111,7 @@ jobs:
   test:
     if: github.repository == 'fern-api/fern'
     runs-on: Test
-    timeout-minutes: 15
+    timeout-minutes: 25
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4
@@ -164,7 +164,7 @@ jobs:
   test-ete:
     if: github.repository == 'fern-api/fern'
     runs-on: Test
-    timeout-minutes: 15
+    timeout-minutes: 25
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4
@@ -188,24 +188,24 @@ jobs:
         run: go install github.com/fern-api/protoc-gen-openapi/cmd/protoc-gen-openapi@latest
 
       - name: Build CLI (dev)
-        timeout-minutes: 5
+        timeout-minutes: 10
         run: pnpm turbo run dist:cli:dev --filter=@fern-api/cli --filter=@fern-api/cli-v2
 
       - name: Build seed CLI
-        timeout-minutes: 5
+        timeout-minutes: 10
         run: pnpm seed:build
 
       - name: Run ETE tests
         if: ${{ !github.event.inputs.update_snapshots }}
-        timeout-minutes: 10
+        timeout-minutes: 20
         env:
           FERN_ORG_TOKEN_DEV: ${{ secrets.FERN_ORG_TOKEN_DEV }}
         run: |
           FERN_TOKEN=${{ secrets.FERN_ORG_TOKEN_DEV }} pnpm --filter @fern-api/ete-tests test
 
       - name: Run ETE tests with snapshot updates
         if: ${{ github.event.inputs.update_snapshots == 'true' }}
-        timeout-minutes: 10
+        timeout-minutes: 20
         env:
           FERN_ORG_TOKEN_DEV: ${{ secrets.FERN_ORG_TOKEN_DEV }}
         run: |

.github/workflows/update-test.yml

@@ -8,20 +8,22 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-permissions:
-  contents: write
-
 env:
   DO_NOT_TRACK: "1"
+  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
+  TURBO_TEAM: "buildwithfern"
+  TURBO_REMOTE_CACHE_TIMEOUT: 60
 
 jobs:
   update-test:
     if: github.repository == 'fern-api/fern' && github.ref != 'refs/heads/main'
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
+    runs-on: Test
+    timeout-minutes: 90
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4
+        with:
+          lfs: true
 
       - name: Install
         uses: ./.github/actions/install
@@ -30,6 +32,9 @@ jobs:
         with:
           github_token: ${{ github.token }}
 
+      - name: Verify buf
+        run: buf --version
+
       - uses: actions/setup-go@v5
         with:
           go-version: "stable"
@@ -41,15 +46,29 @@ jobs:
       - name: Run test:update
         run: pnpm test:update
 
+      - name: Build CLI (dev)
+        timeout-minutes: 15
+        run: pnpm turbo run dist:cli:dev --filter=@fern-api/cli --filter=@fern-api/cli-v2
+
+      - name: Build seed CLI
+        timeout-minutes: 15
+        run: pnpm seed:build
+
       - name: Run test:ete:update
+        timeout-minutes: 30
         env:
           FERN_ORG_TOKEN_DEV: ${{ secrets.FERN_ORG_TOKEN_DEV }}
-        run: FERN_TOKEN=${{ secrets.FERN_ORG_TOKEN_DEV }} pnpm test:ete:update
+        run: |
+          FERN_TOKEN=${{ secrets.FERN_ORG_TOKEN_DEV }} pnpm --filter @fern-api/ete-tests test -- -u
 
       - name: Commit and Push Changes
-        uses: EndBug/add-and-commit@v9
-        with:
-          add: "."
-          push: true
-          fetch: false
-          message: "chore: update test snapshots"
+        run: |
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+          git add .
+          if ! git diff --staged --quiet; then
+            git commit -m "chore: update test snapshots"
+            git push
+          else
+            echo "No snapshot changes to commit"
+          fi

.vscode/settings.json

@@ -129,7 +129,7 @@
   "typescript.disableAutomaticTypeAcquisition": true,
   "typescript.updateImportsOnFileMove.enabled": "never",
   "javascript.updateImportsOnFileMove.enabled": "never",
-  "extensions.ignoreRecommendations": false,
+  "extensions.ignoreRecommendations": true,
   "git.ignoreLimitWarning": true,
   "git.branchProtection": ["main", "master"]
 }

docs-yml.schema.json

@@ -1497,6 +1497,26 @@
             }
           ]
         },
+        "collapsible": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "collapsed-by-default": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "slug": {
           "oneOf": [
             {
@@ -2776,6 +2796,26 @@
             }
           ]
         },
+        "collapsible": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "collapsed-by-default": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "availability": {
           "oneOf": [
             {

fern/apis/docs-yml/definition/docs.yml

@@ -1093,7 +1093,19 @@ types:
         docs: |
           The relative path to the markdown file that will be displayed when the section is clicked.
       contents: list<NavigationItem>
-      collapsed: optional<boolean>
+      collapsed:
+        type: optional<boolean>
+        docs: |
+          Deprecated. Use `collapsible` and `collapsed-by-default` instead.
+        availability: deprecated
+      collapsible:
+        type: optional<boolean>
+        docs: |
+          Whether the section can be expanded/collapsed by the user.
+      collapsed-by-default:
+        type: optional<boolean>
+        docs: |
+          Whether the section starts collapsed. Only meaningful when `collapsible` is true. Defaults to false (starts open).
       slug: optional<string>
       icon: optional<string>
       hidden: optional<boolean>
@@ -1119,7 +1131,19 @@ types:
       icon: optional<string>
       hidden: optional<boolean>
       skip-slug: optional<boolean>
-      collapsed: optional<boolean>
+      collapsed:
+        type: optional<boolean>
+        docs: |
+          Deprecated. Use `collapsible` and `collapsed-by-default` instead.
+        availability: deprecated
+      collapsible:
+        type: optional<boolean>
+        docs: |
+          Whether the section can be expanded/collapsed by the user.
+      collapsed-by-default:
+        type: optional<boolean>
+        docs: |
+          Whether the section starts collapsed. Only meaningful when `collapsible` is true. Defaults to false (starts open).
       availability: optional<Availability>
 
   TitleSource:
@@ -1156,7 +1180,9 @@ types:
         type: optional<list<ApiReferenceLayoutItem>>
         docs: |
           Advanced usage: when specified, this object will be used to customize the order that your API endpoints are displayed in the docs site, including subpackages, and additional markdown pages (to be rendered in between API endpoints). If not specified, the order will be inferred from the OpenAPI Spec or Fern Definition.
-      collapsed: optional<boolean>
+      collapsed:
+        type: optional<boolean>
+        availability: deprecated
       icon: optional<string>
       slug: optional<string>
       hidden: optional<boolean>

fern/apis/generators-yml/definition/generators.yml

@@ -4,6 +4,7 @@ imports:
   file: ./fernDefinition/file.yml
   environments: ./fernDefinition/environments.yml
   group: ./group.yml
+  replay: ./replay.yml
   reviewers: ./reviewers.yml
 types:
   GeneratorsConfigurationSchema:
@@ -36,6 +37,11 @@ types:
         type: optional<map<string, group.GeneratorGroupSchema>>
       reviewers:
         type: optional<reviewers.ReviewersSchema>
+      replay:
+        type: optional<replay.ReplayConfigSchema>
+        docs: |
+          Configuration for SDK customization replay.
+          Automatically preserves user customizations across SDK regenerations.
       ai: optional<ai.AIServicesSchema>
       autorelease:
         type: optional<boolean>

fern/apis/generators-yml/definition/replay.yml

@@ -0,0 +1,6 @@
+types:
+  ReplayConfigSchema:
+    properties:
+      enabled:
+        type: boolean
+        docs: Whether to enable replay for this SDK

generators-yml.schema.json

@@ -103,6 +103,16 @@
         }
       ]
     },
+    "replay": {
+      "oneOf": [
+        {
+          "$ref": "#/definitions/replay.ReplayConfigSchema"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
     "ai": {
       "oneOf": [
         {
@@ -4139,6 +4149,18 @@
       ],
       "additionalProperties": false
     },
+    "replay.ReplayConfigSchema": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "enabled"
+      ],
+      "additionalProperties": false
+    },
     "ai.ModelProvider": {
       "type": "string",
       "enum": [

packages/cli/cli-v2/package.json

@@ -82,9 +82,10 @@
     "inquirer": "^9.2.15",
     "is-ci": "catalog:",
     "js-yaml": "catalog:",
+    "yaml": "catalog:",
     "jsonwebtoken": "catalog:",
     "ora": "catalog:",
-    "posthog-node": "^4.3.2",
+    "posthog-node": "^5.14.0",
     "tsup": "catalog:",
     "typescript": "catalog:",
     "uuid": "catalog:",

packages/cli/cli-v2/src/api/adapter/LegacyFernWorkspaceAdapter.ts

@@ -146,6 +146,7 @@ export class LegacyFernWorkspaceAdapter {
             groups: [],
             whitelabel: undefined,
             ai: undefined,
+            replay: undefined,
             rawConfiguration: {}
         };
     }

packages/cli/cli-v2/src/commands/init/command.ts

@@ -4,6 +4,7 @@ import chalk from "chalk";
 import { mkdir, writeFile } from "fs/promises";
 import path from "path";
 import type { Argv } from "yargs";
+import { FERN_YML_FILENAME } from "../../config/fern-yml/constants";
 import { FernYmlBuilder } from "../../config/fern-yml/FernYmlBuilder";
 import type { Context } from "../../context/Context";
 import type { GlobalArgs } from "../../context/GlobalArgs";
@@ -21,7 +22,6 @@ export declare namespace InitCommand {
     }
 }
 
-const FERN_YML_FILENAME = "fern.yml";
 const SPECS_DIR = "openapi";
 
 export class InitCommand {