Add readable and fast compiled model modes

.gitattributes

@@ -0,0 +1,2 @@
+# Generated bundles may preserve whitespace inside dependency template literals.
+frontend/dist/assets/*.js -whitespace

.github/workflows/Benchmarks.yml

@@ -3,23 +3,109 @@ on:
   pull_request_target:
     branches: [ main ]
   workflow_dispatch:
+    inputs:
+      full_performance:
+        description: Run the complete downstream performance workflow
+        required: false
+        default: false
+        type: boolean
 permissions:
   pull-requests: write
+  contents: read
 jobs:
   bench:
-    name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ github.event_name }}
+    if: ${{ github.event_name != 'workflow_dispatch' || !inputs.full_performance }}
+    name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ matrix.arch }} - ${{
+      github.event_name }}
     runs-on: ${{ matrix.os }}
     timeout-minutes: 60
+    env:
+      PSE_BENCHMARK_INCLUDE_DOWNSTREAM: "false"
     strategy:
       fail-fast: false
       matrix:
         version:
-          - "1"
+          - "1.12.1"
         os:
           - ubuntu-latest
+        arch:
+          - x64
     steps:
       - uses: MilesCranmer/AirspeedVelocity.jl@action-v1
         with:
           julia-version: ${{ matrix.version }}
           bench-on: ${{ github.event.pull_request.head.sha }}
-          extra-pkgs: https://github.com/PalmStudio/XPalm.jl,https://github.com/VEZY/PlantBiophysics.jl
+
+  plantbiophysics:
+    if: ${{ github.event_name != 'workflow_dispatch' || !inputs.full_performance }}
+    name: PlantBiophysics multi-timestep
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    permissions:
+      contents: read
+    env:
+      JULIA_NUM_THREADS: "1"
+      JULIA_PKG_PRECOMPILE_AUTO: "0"
+      PSE_PLANTBIOPHYSICS_BENCHMARK_STEPS: "1000"
+      PSE_PLANTBIOPHYSICS_BENCHMARK_SAMPLES: "5"
+      PSE_PLANTBIOPHYSICS_FANOUT_SCENES: "20"
+    steps:
+      - name: Check out PlantSimEngine
+        uses: actions/checkout@v7
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
+
+      - name: Check out PlantBiophysics
+        uses: actions/checkout@v7
+        with:
+          repository: VEZY/PlantBiophysics.jl
+          ref: multi-plant
+          path: downstream/PlantBiophysics
+
+      - name: Set up Julia
+        uses: julia-actions/setup-julia@v3
+        with:
+          version: "1.12.1"
+
+      - name: Cache Julia packages
+        uses: julia-actions/cache@v3
+
+      - name: Resolve the PlantBiophysics benchmark environment
+        shell: julia --project=benchmark --color=yes {0}
+        run: |
+          using Pkg
+
+          benchmark_project = joinpath(pwd(), "benchmark", "Project.toml")
+          include(joinpath(pwd(), "benchmark", "prepare_full_performance_project.jl"))
+          prepare_plantbiophysics_performance_project!(benchmark_project)
+          Pkg.activate(joinpath(pwd(), "benchmark"))
+          Pkg.develop([
+              PackageSpec(path=pwd()),
+              PackageSpec(path=joinpath(pwd(), "downstream", "PlantBiophysics")),
+          ])
+          Pkg.resolve()
+          Pkg.instantiate()
+          Pkg.precompile()
+
+      - name: Run the warmed multi-timestep benchmark
+        run: >-
+          julia --project=benchmark --color=yes
+          benchmark/test/runtests.jl
+          "PlantBiophysics benchmark (API smoke|performance)"
+
+      - name: Persist measurements
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: plantbiophysics-performance-${{ github.run_id }}-${{ github.run_attempt }}
+          path: benchmark/results/plantbiophysics-full-latest.csv
+          if-no-files-found: warn
+          retention-days: 30
+
+  full-performance:
+    if: ${{ github.event_name == 'workflow_dispatch' && inputs.full_performance }}
+    uses: ./.github/workflows/FullPerformance.yml
+    with:
+      xpalm_ref: codex/xpalm-release-regression
+      plantbiophysics_ref: multi-plant
+      plantgeom_ref: plantsimengine-multi-plant

.github/workflows/FullPerformance.yml

@@ -0,0 +1,139 @@
+name: Full downstream performance
+
+on:
+  schedule:
+    - cron: "17 2 * * *"
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      xpalm_ref:
+        description: XPalm branch, tag, or commit
+        required: true
+        default: main
+        type: string
+      plantbiophysics_ref:
+        description: PlantBiophysics branch, tag, or commit
+        required: true
+        default: master
+        type: string
+      plantgeom_ref:
+        description: PlantGeom branch, tag, or commit
+        required: true
+        default: plantsimengine-multi-plant
+        type: string
+  workflow_call:
+    inputs:
+      xpalm_ref:
+        description: XPalm branch, tag, or commit
+        required: false
+        default: main
+        type: string
+      plantbiophysics_ref:
+        description: PlantBiophysics branch, tag, or commit
+        required: false
+        default: master
+        type: string
+      plantgeom_ref:
+        description: PlantGeom branch, tag, or commit
+        required: false
+        default: plantsimengine-multi-plant
+        type: string
+
+permissions:
+  contents: read
+
+concurrency:
+  group: full-downstream-performance-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  full-downstream-performance:
+    name: PlantBiophysics and XPalm
+    runs-on: ubuntu-24.04
+    timeout-minutes: 45
+    env:
+      JULIA_NUM_THREADS: "1"
+      JULIA_PKG_PRECOMPILE_AUTO: "0"
+      PSE_BENCHMARK_INCLUDE_DOWNSTREAM: "true"
+      PSE_PLANTBIOPHYSICS_BENCHMARK_STEPS: "8760"
+      PSE_PLANTBIOPHYSICS_BENCHMARK_SAMPLES: "10"
+      PSE_PLANTBIOPHYSICS_FANOUT_SCENES: "100"
+    steps:
+      - name: Check out PlantSimEngine
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
+
+      - name: Check out XPalm
+        uses: actions/checkout@v6
+        with:
+          repository: PalmStudio/XPalm.jl
+          ref: ${{ inputs.xpalm_ref || 'main' }}
+          path: downstream/XPalm
+
+      - name: Check out PlantBiophysics
+        uses: actions/checkout@v6
+        with:
+          repository: VEZY/PlantBiophysics.jl
+          ref: ${{ inputs.plantbiophysics_ref || 'master' }}
+          path: downstream/PlantBiophysics
+
+      - name: Check out PlantGeom
+        uses: actions/checkout@v6
+        with:
+          repository: VEZY/PlantGeom.jl
+          ref: ${{ inputs.plantgeom_ref || 'plantsimengine-multi-plant' }}
+          path: downstream/PlantGeom
+
+      - name: Set up Julia
+        uses: julia-actions/setup-julia@v3
+        with:
+          version: "1.12.1"
+
+      - name: Cache Julia packages
+        uses: julia-actions/cache@v3
+
+      - name: Resolve and instantiate the benchmark environment
+        shell: julia --project=benchmark --color=yes {0}
+        run: |
+          using Pkg
+
+          benchmark_project = joinpath(pwd(), "benchmark", "Project.toml")
+          include(joinpath(pwd(), "benchmark", "prepare_full_performance_project.jl"))
+          prepare_full_performance_project!(benchmark_project)
+          Pkg.activate(joinpath(pwd(), "benchmark"))
+          Pkg.develop([
+              PackageSpec(path=pwd()),
+              PackageSpec(path=joinpath(pwd(), "downstream", "XPalm")),
+              PackageSpec(path=joinpath(pwd(), "downstream", "PlantBiophysics")),
+              PackageSpec(path=joinpath(pwd(), "downstream", "PlantGeom")),
+          ])
+          Pkg.resolve()
+          Pkg.instantiate()
+          Pkg.precompile()
+
+      - name: Run the PlantBiophysics API and performance benchmark
+        run: >-
+          julia --project=benchmark --color=yes
+          benchmark/test/runtests.jl
+          "PlantBiophysics benchmark (API smoke|performance)"
+
+      - name: Run the complete XPalm performance and correctness matrix
+        run: >-
+          julia --project=benchmark --color=yes
+          benchmark/test/runtests.jl
+          "XPalm staged performance profile full"
+
+      - name: Persist measurements and the resolved environment
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: downstream-full-performance-${{ github.run_id }}-${{ github.run_attempt }}
+          path: |
+            benchmark/results/plantbiophysics-full-latest.csv
+            benchmark/results/xpalm-full-latest.csv
+            benchmark/Manifest.toml
+          if-no-files-found: warn
+          retention-days: 90

.gitignore

@@ -7,5 +7,8 @@ docs/Manifest.toml
 test/Manifest.toml
 docs/build/
 benchmark/Manifest.toml
-frontend/node_modules/
-docs/src/www/simple_dependency_graph.html
+benchmark/results/
+/frontend/node_modules/
+/frontend/.vite/
+/frontend/test-results/
+/frontend/playwright-report/