chore(seed): Adjust devbox and scripts to enable seed --local for all sdk generators

.gitignore

@@ -111,6 +111,7 @@ seed/**/.pytest_cache/
 seed/**/.mypy_cache/
 seed/**/.ruff_cache/
 seed/**/*.egg-info/
+seed/**/.golangci.yml
 
 # Seed remote-local test outputs, except for seed.yml files
 seed-remote-local/*
@@ -119,5 +120,9 @@ seed-remote-local/*
 # Test logs from test-remote-local.sh
 test-remote-local-logs-*/
 
+# macOS system dirs leaked by local Poetry/Python execution
+seed/**/Library/Application Support/
+seed/**/Library/Caches/
+
 # Devbox gradle properties
 /gradle.properties

devbox.json

@@ -8,10 +8,9 @@
     "poetry@1.8",
     "jdk@17",
     "gradle@8.5",
-    "ruby@3.3",
+    "ruby@3.4",
     "rubocop@latest",
     "php@8.4",
-    "php84Packages.composer@2.7",
     "rustup@latest",
     "ruff@0.15",
     "buf@1.50.0",
@@ -28,10 +27,17 @@
       "printf '\\033]0;%s\\007' 'fern (devbox)'",
       "unset GOROOT # Unset GOROOT from parent shell to avoid conflicts with devbox's Go",
       "export PATH=\"$(go env GOPATH)/bin:$PATH\"",
+      "command -v golangci-lint &>/dev/null || { echo 'Installing golangci-lint...'; go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.10.1 2>/dev/null || true; }",
+      "mkdir -p \"$HOME/.local/bin\"",
+      "if [ ! -f \"$HOME/.local/bin/composer\" ]; then echo 'Installing composer...'; curl -sSL https://getcomposer.org/download/latest-2.x/composer.phar -o \"$HOME/.local/bin/composer\" && chmod +x \"$HOME/.local/bin/composer\"; fi",
+      "if [ ! -f \"$HOME/.local/bin/php-cs-fixer\" ]; then echo 'Installing php-cs-fixer...'; curl -sSL https://cs.symfony.com/download/php-cs-fixer-v3.phar -o \"$HOME/.local/bin/php-cs-fixer\" && chmod +x \"$HOME/.local/bin/php-cs-fixer\"; fi",
+      "export PATH=\"$HOME/.local/bin:$PATH\"",
+      "if [ -f /usr/bin/xcrun ]; then mkdir -p \"$HOME/.local/bin\" && ln -sf /usr/bin/xcrun \"$HOME/.local/bin/xcrun\"; fi # Use system xcrun instead of nix xcbuild",
       "rustup default stable 2>/dev/null || true",
       "rustup component add rustfmt 2>/dev/null || true",
       "bash scripts/setup-dotnet.sh 2>/dev/null || true",
-      "export PATH=\"$HOME/.dotnet:$PATH\"",
+      "export DOTNET_ROOT=\"$HOME/.dotnet\"",
+      "export PATH=\"$HOME/.dotnet:$HOME/.dotnet/tools:$PATH\"",
       "echo 'Node.js:' $(node --version)",
       "echo 'pnpm:' $(pnpm --version 2>/dev/null || echo 'not available')",
       "echo 'Go:' $(go version)",

devbox.lock

@@ -483,54 +483,6 @@
         }
       }
     },
-    "php84Packages.composer@2.7": {
-      "last_modified": "2024-10-02T21:32:52Z",
-      "resolved": "github:NixOS/nixpkgs/fd698a4ab779fb7fb95425f1b56974ba9c2fa16c#php84Packages.composer",
-      "source": "devbox-search",
-      "version": "2.7.9",
-      "systems": {
-        "aarch64-darwin": {
-          "outputs": [
-            {
-              "name": "out",
-              "path": "/nix/store/nh3pqv4bsgivzvmc919sqvv8km265c77-composer-2.7.9",
-              "default": true
-            }
-          ],
-          "store_path": "/nix/store/nh3pqv4bsgivzvmc919sqvv8km265c77-composer-2.7.9"
-        },
-        "aarch64-linux": {
-          "outputs": [
-            {
-              "name": "out",
-              "path": "/nix/store/iardqmy3i0cy4l9r045p7g5qb9dca8p9-composer-2.7.9",
-              "default": true
-            }
-          ],
-          "store_path": "/nix/store/iardqmy3i0cy4l9r045p7g5qb9dca8p9-composer-2.7.9"
-        },
-        "x86_64-darwin": {
-          "outputs": [
-            {
-              "name": "out",
-              "path": "/nix/store/x6z4hy24dn5l9inqcs4a5wm5layiil67-composer-2.7.9",
-              "default": true
-            }
-          ],
-          "store_path": "/nix/store/x6z4hy24dn5l9inqcs4a5wm5layiil67-composer-2.7.9"
-        },
-        "x86_64-linux": {
-          "outputs": [
-            {
-              "name": "out",
-              "path": "/nix/store/9ajnzd7i6ywxv7mav92032iryrc4jm0g-composer-2.7.9",
-              "default": true
-            }
-          ],
-          "store_path": "/nix/store/9ajnzd7i6ywxv7mav92032iryrc4jm0g-composer-2.7.9"
-        }
-      }
-    },
     "php@8.4": {
       "last_modified": "2026-03-21T07:29:51Z",
       "plugin_version": "0.0.3",
@@ -750,68 +702,68 @@
         }
       }
     },
-    "ruby@3.3": {
-      "last_modified": "2026-01-23T17:20:52Z",
+    "ruby@3.4": {
+      "last_modified": "2026-03-21T07:29:51Z",
       "plugin_version": "0.0.2",
-      "resolved": "github:NixOS/nixpkgs/a1bab9e494f5f4939442a57a58d0449a109593fe#ruby",
+      "resolved": "github:NixOS/nixpkgs/09061f748ee21f68a089cd5d91ec1859cd93d0be#ruby",
       "source": "devbox-search",
-      "version": "3.3.10",
+      "version": "3.4.8",
       "systems": {
         "aarch64-darwin": {
           "outputs": [
             {
               "name": "out",
-              "path": "/nix/store/d9wal8y7w1zpvyas3x1q4ykz880mmklk-ruby-3.3.10",
+              "path": "/nix/store/88sazm3fj9kabg4pxmnjc53cx0syp8fk-ruby-3.4.8",
               "default": true
             },
             {
               "name": "devdoc",
-              "path": "/nix/store/1rfqp0848j3gnm222ls3bipk1azcrrq3-ruby-3.3.10-devdoc"
+              "path": "/nix/store/mk7a50jsk138apqrnlzc077cik8cr47m-ruby-3.4.8-devdoc"
             }
           ],
-          "store_path": "/nix/store/d9wal8y7w1zpvyas3x1q4ykz880mmklk-ruby-3.3.10"
+          "store_path": "/nix/store/88sazm3fj9kabg4pxmnjc53cx0syp8fk-ruby-3.4.8"
         },
         "aarch64-linux": {
           "outputs": [
             {
               "name": "out",
-              "path": "/nix/store/1hlahw0ijkxx1aqy3x41k3gxpgv34g7d-ruby-3.3.10",
+              "path": "/nix/store/rpcpk0lxd8iliza4nl9apsgrpsb2yk4d-ruby-3.4.8",
               "default": true
             },
             {
               "name": "devdoc",
-              "path": "/nix/store/arvi0gqvw07ngbi2ci20dn5ka2jz5irv-ruby-3.3.10-devdoc"
+              "path": "/nix/store/9wnq7dd2yw2lbjs69y19lm08ranqa930-ruby-3.4.8-devdoc"
             }
           ],
-          "store_path": "/nix/store/1hlahw0ijkxx1aqy3x41k3gxpgv34g7d-ruby-3.3.10"
+          "store_path": "/nix/store/rpcpk0lxd8iliza4nl9apsgrpsb2yk4d-ruby-3.4.8"
         },
         "x86_64-darwin": {
           "outputs": [
             {
               "name": "out",
-              "path": "/nix/store/as6xdshxpansvkag8zqr602ajkn9079z-ruby-3.3.10",
+              "path": "/nix/store/gq0vdqfz16vf64ip8p749rmygxd7n3x1-ruby-3.4.8",
               "default": true
             },
             {
               "name": "devdoc",
-              "path": "/nix/store/wix1487x3br4gxa0il4q6llz5xyqxspl-ruby-3.3.10-devdoc"
+              "path": "/nix/store/k3yn26wvgk4mfrd5nw4a23wnijd9hz6c-ruby-3.4.8-devdoc"
             }
           ],
-          "store_path": "/nix/store/as6xdshxpansvkag8zqr602ajkn9079z-ruby-3.3.10"
+          "store_path": "/nix/store/gq0vdqfz16vf64ip8p749rmygxd7n3x1-ruby-3.4.8"
         },
         "x86_64-linux": {
           "outputs": [
             {
               "name": "out",
-              "path": "/nix/store/6jz2pgmsh06z9a83qi33f6lp9w2q6mzm-ruby-3.3.10",
+              "path": "/nix/store/s57rf37r1i38kpm3nlv4h8f8z2w2n80d-ruby-3.4.8",
               "default": true
             },
             {
               "name": "devdoc",
-              "path": "/nix/store/kah8xsbcd10iakxqmlw558iarhsrd5vi-ruby-3.3.10-devdoc"
+              "path": "/nix/store/4k6c15chplw6cicc6f3lgzmi7i4792j6-ruby-3.4.8-devdoc"
             }
           ],
-          "store_path": "/nix/store/6jz2pgmsh06z9a83qi33f6lp9w2q6mzm-ruby-3.3.10"
+          "store_path": "/nix/store/s57rf37r1i38kpm3nlv4h8f8z2w2n80d-ruby-3.4.8"
         }
       }
     },

generators/base/src/AbstractGeneratorAgent.ts

@@ -10,6 +10,7 @@ import { ReferenceConfigBuilder } from "./reference/index.js";
 import { RawGithubConfig, resolveGitHubConfig } from "./utils/index.js";
 
 const FEATURES_CONFIG_PATHS = [
+    ...(process.env.FERN_FEATURES_YML_PATH != null ? [process.env.FERN_FEATURES_YML_PATH] : []),
     "/assets/features.yml",
     path.join(__dirname, "./features.yml"),
     path.join(__dirname, "./assets/features.yml"),

generators/python/setup-python.sh

@@ -1,8 +1,8 @@
-# Use 3.9 because some of our internal SDKs are on extremely old generator
+# Use 3.10 because some of our internal SDKs are on extremely old generator
 # versions that don't support 3.8
 export PYENV_ROOT="$HOME/.pyenv"
 [[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
 eval "$(pyenv init -)"
-pyenv shell 3.9
+pyenv shell 3.10
 pip install poetry
-poetry env use 3.9
+poetry env use 3.10

generators/python/src/fern_python/generators/sdk/as_is_copier.py

@@ -102,8 +102,11 @@ def _copy_directory_to_project(
     path_in_project: str,
     replacements: Optional[Dict[str, str]] = None,
 ) -> None:
-    source = (
-        os.path.join(os.path.dirname(__file__), "../../../../../") if "PYTEST_CURRENT_TEST" in os.environ else "/assets"
+    source = os.environ.get(
+        "FERN_ASSETS_PATH",
+        os.path.join(os.path.dirname(__file__), "../../../../../")
+        if "PYTEST_CURRENT_TEST" in os.environ
+        else "/assets",
     )
 
     for _, _, files in os.walk(os.path.join(source, relative_path_on_disk)):
@@ -130,8 +133,11 @@ def _copy_file_to_project(
     replacements: Optional[Dict[str, str]] = None,
 ) -> None:
     # Project root source, so all from_ requests should be relative to that
-    source = (
-        os.path.join(os.path.dirname(__file__), "../../../../../") if "PYTEST_CURRENT_TEST" in os.environ else "/assets"
+    source = os.environ.get(
+        "FERN_ASSETS_PATH",
+        os.path.join(os.path.dirname(__file__), "../../../../../")
+        if "PYTEST_CURRENT_TEST" in os.environ
+        else "/assets",
     )
     SourceFileFactory.add_source_file_from_disk(
         project=project,

generators/python/src/fern_python/generators/sdk/core_utilities/core_utilities.py

@@ -328,6 +328,23 @@ def copy_to_project(self, *, project: Project) -> None:
         else:
             project.add_dependency(PYDANTIC_DEPENDENCY)
 
+    @staticmethod
+    def _resolve_core_utilities_path(relative_filepath: str) -> str:
+        """Resolve the core utilities source directory.
+
+        Supports FERN_CORE_UTILITIES_PATH env var with colon-separated paths
+        for local execution where sdk/ and shared/ are separate directories.
+        """
+        env_paths = os.environ.get("FERN_CORE_UTILITIES_PATH")
+        if env_paths is not None:
+            for source in env_paths.split(":"):
+                if os.path.exists(os.path.join(source, relative_filepath)):
+                    return source
+            return env_paths.split(":")[0]
+        if "PYTEST_CURRENT_TEST" in os.environ:
+            return os.path.join(os.path.dirname(__file__), "../../../../../core_utilities/sdk")
+        return "/assets/core_utilities"
+
     def _copy_file_to_project(
         self,
         *,
@@ -337,11 +354,7 @@ def _copy_file_to_project(
         exports: Set[str],
         string_replacements: Optional[dict[str, str]] = None,
     ) -> None:
-        source = (
-            os.path.join(os.path.dirname(__file__), "../../../../../core_utilities/sdk")
-            if "PYTEST_CURRENT_TEST" in os.environ
-            else "/assets/core_utilities"
-        )
+        source = self._resolve_core_utilities_path(relative_filepath_on_disk)
         SourceFileFactory.add_source_file_from_disk(
             project=project,
             path_on_disk=os.path.join(source, relative_filepath_on_disk),
@@ -352,11 +365,7 @@ def _copy_file_to_project(
 
     def _copy_http_sse_folder_to_project(self, *, project: Project) -> None:
         """Copy the http_sse folder using the same approach as individual file copying"""
-        source = (
-            os.path.join(os.path.dirname(__file__), "../../../../../core_utilities/sdk")
-            if "PYTEST_CURRENT_TEST" in os.environ
-            else "/assets/core_utilities"
-        )
+        source = self._resolve_core_utilities_path("http_sse")
         folder_path_on_disk = os.path.join(source, "http_sse")
 
         # Define exports for each file

generators/python/src/fern_python/generators/sdk/v2/generator.py

@@ -1,3 +1,4 @@
+import os
 import subprocess
 import sys
 from pathlib import Path
@@ -7,8 +8,8 @@
 import fern.generator_exec as generator_exec
 
 # v2BinPath is the path to the python-v2 binary included in the SDK
-# generator docker image.
-V2_BIN_PATH = "/bin/python-v2"
+# generator docker image. Can be overridden via PYTHON_V2_PATH for local execution.
+V2_BIN_PATH = os.environ.get("PYTHON_V2_PATH", "/bin/python-v2")
 
 
 class PythonV2Generator:

package.json

@@ -95,6 +95,7 @@
     "java:build": "turbo run dockerTagLatest --filter @fern-api/java-sdk",
     "php:build": "turbo run dockerTagLatest --filter @fern-api/php-sdk",
     "python:build": "turbo run dist:cli --filter @fern-api/python-sdk && docker build . -f ./generators/python/sdk/Dockerfile -t fernapi/fern-python-sdk:latest",
+    "python:check:fix": "cd generators/python && bash setup-python.sh && poetry run pre-commit run --all-files",
     "ruby:build": "turbo run dockerTagLatest --filter @fern-api/ruby-sdk",
     "rust:build": "turbo run dockerTagLatest --filter @fern-api/rust-sdk",
     "swift:build": "turbo run dockerTagLatest --filter @fern-api/swift-sdk",

scripts/setup-dotnet.sh

@@ -75,10 +75,25 @@ main() {
         fi
     done
 
+    # Ensure tools path is available for installing global tools
+    export PATH="$HOME/.dotnet:$HOME/.dotnet/tools:$PATH"
+
+    # Install CSharpier if not already installed
+    if ! command -v csharpier &> /dev/null; then
+        echo -e "${YELLOW}Installing CSharpier...${NC}"
+        if dotnet tool install -g csharpier; then
+            echo -e "${GREEN}✓${NC} CSharpier installed successfully"
+        else
+            echo -e "${RED}✗${NC} Failed to install CSharpier"
+        fi
+    else
+        echo -e "${GREEN}✓${NC} CSharpier is already installed"
+    fi
+
     echo ""
-    echo -e "${YELLOW}Make sure \$HOME/.dotnet is in your PATH.${NC}"
+    echo -e "${YELLOW}Make sure \$HOME/.dotnet and \$HOME/.dotnet/tools are in your PATH.${NC}"
     echo "Add to your shell profile (~/.zshrc, ~/.bashrc, etc):"
-    echo "  export PATH=\"\$HOME/.dotnet:\$PATH\""
+    echo "  export PATH=\"\$HOME/.dotnet:\$HOME/.dotnet/tools:\$PATH\""
     echo ""
     echo "Alternatively, follow the official Microsoft installation guide:"
     echo "  https://learn.microsoft.com/en-us/dotnet/core/install/"

seed/java-sdk/seed.yml

@@ -361,9 +361,14 @@ fixtures:
       outputFolder: source-root
       skipScripts: true
 scripts:
-  - image: fernapi/java-seed
-    commands:
-      - source ~/.bash_profile && jenv shell 1.8 && source ~/.bash_profile && ./gradlew compileJava spotlessCheck
+  docker:
+    - image: fernapi/java-seed
+      commands:
+        - source ~/.bash_profile && jenv shell 1.8 && source ~/.bash_profile && ./gradlew compileJava spotlessCheck
+  local:
+    - commands:
+      - ./gradlew compileJava spotlessCheck
+
 allowedFailures:
   - alias-extends
   - enum:forward-compatible-enums

seed/python-sdk/seed.yml

@@ -33,10 +33,14 @@ test:
       - chmod +x setup-python.sh && ./setup-python.sh
       - poetry config virtualenvs.in-project true
       - poetry install
-    # The envvar is needed to trick the generator to look in the right place for the core_utils files
+      - (cd ../../ && pnpm turbo run dist:cli --filter @fern-api/python-sdk)
     runCommand: poetry run python -m src.fern_python.generators.sdk.cli {CONFIG_PATH}
     env:
       PYTEST_CURRENT_TEST: "some value"
+      PYTHON_V2_PATH: ../../generators/python-v2/sdk/dist/cli.cjs
+      FERN_CORE_UTILITIES_PATH: ../../generators/python/core_utilities/sdk:../../generators/python/core_utilities/shared
+      FERN_ASSETS_PATH: ../../generators/python
+      FERN_FEATURES_YML_PATH: ../../generators/python/sdk/features.yml
 
 language: python
 generatorType: SDK