freedyn2 0.1.0rc1__tar.gz

freedyn2-0.1.0rc1/.gitattributes

@@ -0,0 +1,5 @@
+# Windows batch files need CRLF line endings; the installer's texts are shown on Windows
+*.cmd text eol=crlf
+*.bat text eol=crlf
+installer/windows/*.txt text eol=crlf
+installer/windows/*.iss text eol=crlf

freedyn2-0.1.0rc1/.github/workflows/ci.yml

@@ -0,0 +1,127 @@
+name: CI
+
+on:
+  push:
+    branches: [main]  # work branches run once, through their pull request
+  pull_request:
+
+# a new push to a pull request cancels its runs still in progress
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libeigen3-dev libsuitesparse-dev
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements-dev.txt
+      - name: Lint
+        run: python -m pyflakes generator legacy tests/python examples/extension tools installer
+      - name: Configure and build
+        run: |
+          cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DPython3_EXECUTABLE="$(which python)"
+          cmake --build build -j
+      - name: C++ tests
+        run: ctest --test-dir build --output-on-failure -V
+      - name: Python tests (with the runtime built)
+        run: python -m pytest -v
+      - name: freedyn2 run (.fds and .yaml, model plugin)
+        env:
+          PYTHONPATH: generator
+        run: |
+          python -m fdgen.cli run examples/compare/pendulum.fds -o pendulum.csv
+          python -m fdgen.cli run examples/compare/spline_spring.fds -o spline_spring.csv
+          python -m fdgen.cli run examples/driven_rotor.yaml -o driven_rotor.csv -- --linear-solver klu
+
+  # Windows: MSVC; Eigen and KLU (SuiteSparse with only KLU and its parts, no BLAS, as DLLs:
+  # LGPL, linked dynamically) from tools/build_deps.py as for the wheels, cached; model plugins
+  # compiled with MSVC (CC=cl) as a user with Visual Studio Build Tools would.
+  windows:
+    runs-on: windows-latest
+    env:
+      CC: cl
+      PYTHONPATH: generator
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: ilammy/msvc-dev-cmd@v1
+      - uses: actions/cache@v4
+        with:
+          path: deps
+          key: deps-${{ runner.os }}-msvc-${{ hashFiles('tools/build_deps.py') }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements-dev.txt
+          python tools/build_deps.py deps
+      - name: Configure and build
+        run: |
+          cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$PWD\deps" `
+            -DPython3_EXECUTABLE="$((Get-Command python).Source)"
+          cmake --build build
+      - name: C++ tests
+        run: ctest --test-dir build --output-on-failure
+      - name: Python tests
+        run: python -m pytest -v
+      - name: freedyn2 run (.fds and .yaml, model plugin)
+        run: |
+          python -m fdgen.cli run examples/compare/pendulum.fds -o pendulum.csv
+          python -m fdgen.cli run examples/driven_rotor.yaml -o driven_rotor.csv -- --linear-solver klu
+
+  # FreeDyn 2 against the legacy kernel (freedyn-org/me, private). Needs a repository
+  # secret FREEDYN_ME_TOKEN with read access to freedyn-org/me; skipped without it.
+  legacy-compare:
+    runs-on: ubuntu-24.04
+    env:
+      HAS_TOKEN: ${{ secrets.FREEDYN_ME_TOKEN != '' }}
+    steps:
+      - name: Notice
+        if: env.HAS_TOKEN != 'true'
+        run: echo "::notice::FREEDYN_ME_TOKEN is not set, legacy comparison skipped"
+      - uses: actions/checkout@v4
+        if: env.HAS_TOKEN == 'true'
+      - uses: actions/checkout@v4
+        if: env.HAS_TOKEN == 'true'
+        with:
+          repository: freedyn-org/me
+          token: ${{ secrets.FREEDYN_ME_TOKEN }}
+          path: me
+      - uses: actions/setup-python@v5
+        if: env.HAS_TOKEN == 'true'
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        if: env.HAS_TOKEN == 'true'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libeigen3-dev libsuitesparse-dev
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements-dev.txt mkl-devel
+      - name: Build FreeDyn 2
+        if: env.HAS_TOKEN == 'true'
+        run: |
+          cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DPython3_EXECUTABLE="$(which python)"
+          cmake --build build -j
+      - name: Build legacy FreeDyn
+        if: env.HAS_TOKEN == 'true'
+        run: MKL_ROOT="$(python -c 'import sys; print(sys.prefix)')" python legacy/build_legacy.py me -o build/legacy
+      - name: Compare
+        if: env.HAS_TOKEN == 'true'
+        run: |
+          python -m pytest -v tests/python/test_legacy_compare.py tests/python/test_legacy_physics.py
+          python legacy/compare.py examples/compare/*.fds --level exact --markdown exact.md
+          python legacy/compare.py examples/compare/*.fds --level physics --markdown physics.md
+          PYTHONPATH=generator python -m fdgen.cli compare examples/compare/*.fds --legacy build/legacy/build/FreeDyn --markdown demo.md
+          { echo "### freedyn2 compare (both programs on the same .fds, converged reference)"; cat demo.md; echo
+            echo "### Exact (legacy profile)"; cat exact.md; echo; echo "### Physics (v2 profile vs reference)"; cat physics.md; } >> "$GITHUB_STEP_SUMMARY"

freedyn2-0.1.0rc1/.github/workflows/docs.yml

@@ -0,0 +1,58 @@
+name: Docs
+
+# The user documentation (mkdocs.yml, docs/) with the live examples (tools/docs_examples.py:
+# viewers exported with the runtime). Built on every pull request that touches it; published
+# to GitHub Pages from main once Pages is enabled (Settings → Pages → Source: GitHub Actions,
+# and the repository variable PAGES_ENABLED = true).
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    paths: [docs/**, mkdocs.yml, tools/docs_*.py, examples/**, schema/**, generator/fdgen/view/**, .github/workflows/docs.yml]
+  workflow_dispatch:
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libeigen3-dev libsuitesparse-dev
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements-dev.txt -r requirements-docs.txt
+      - name: Build the runtime
+        run: |
+          cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DFD_BUILD_EXAMPLES=OFF -DBUILD_TESTING=OFF -DPython3_EXECUTABLE="$(which python)"
+          cmake --build build -j --target freedyn2_run freedyn2_road
+      - name: Live examples
+        run: python tools/docs_examples.py
+      - name: Build the site
+        run: mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        if: github.ref == 'refs/heads/main' && vars.PAGES_ENABLED == 'true'
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    if: github.ref == 'refs/heads/main' && vars.PAGES_ENABLED == 'true'
+    runs-on: ubuntu-24.04
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

freedyn2-0.1.0rc1/.github/workflows/wheels.yml

@@ -0,0 +1,340 @@
+name: Wheels
+
+# Wheels for Windows and Linux (pip install / uv tool install freedyn2): the Python package with
+# the compiled runtime and its KLU libraries (pyproject.toml: scikit-build-core, cibuildwheel), and
+# the Windows installer built from the Windows wheel (installer/windows).
+# Runs for pull requests that change the packaging, by hand, and for version tags. A version tag
+# (v0.1.0, ...) must equal the version in pyproject.toml; it publishes to PyPI (trusted publishing:
+# the PyPI project must have this repository and workflow registered as a trusted publisher,
+# environment "pypi"), creates the GitHub Release with the wheels, the sdist and the installer,
+# and updates the winget package (secret WINGET_TOKEN). Maintainers: docs/releasing.md.
+#
+# Code signing (optional, on version tags only): SignPath (SignPath Foundation for open-source
+# projects), enabled by the secret SIGNPATH_API_TOKEN and the variables SIGNPATH_ORGANIZATION_ID,
+# SIGNPATH_PROJECT_SLUG, SIGNPATH_SIGNING_POLICY_SLUG, SIGNPATH_CONFIG_PROGRAMS,
+# SIGNPATH_CONFIG_INSTALLER (artifact configurations: installer/windows/signpath). Without the token
+# the installer is built unsigned. Another signer replaces the two steps "Sign the programs" and
+# "Sign the installer": they read build/installer/to-sign and dist-installer and write the signed
+# files back to the same places.
+on:
+  pull_request:
+    paths: [pyproject.toml, CMakeLists.txt, tools/**, installer/**, .github/workflows/wheels.yml]
+  workflow_dispatch:
+  push:
+    tags: ["v*"]
+
+concurrency:
+  group: wheels-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  version:
+    runs-on: ubuntu-24.04
+    outputs:
+      version: ${{ steps.v.outputs.version }}
+      prerelease: ${{ steps.v.outputs.prerelease }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Version of pyproject.toml (equal to the tag for a release)
+        id: v
+        run: |
+          v=$(python3 -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')
+          echo "version=$v" >> "$GITHUB_OUTPUT"
+          if [[ "$v" =~ [a-zA-Z] ]]; then echo "prerelease=true" >> "$GITHUB_OUTPUT"; else echo "prerelease=false" >> "$GITHUB_OUTPUT"; fi
+          if [[ "$GITHUB_REF" == refs/tags/v* && "${GITHUB_REF_NAME#v}" != "$v" ]]; then
+            echo "::error::tag $GITHUB_REF_NAME does not match the version $v in pyproject.toml (expected tag v$v)"
+            exit 1
+          fi
+          echo "version $v"
+
+  wheels:
+    needs: [version]
+    strategy:
+      matrix:
+        os: [ubuntu-24.04, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/cache@v4  # the dependencies of the Windows build (on Linux they are built in the container)
+        if: runner.os == 'Windows'
+        with:
+          path: C:/fd-deps
+          key: wheel-deps-${{ runner.os }}-${{ hashFiles('tools/build_deps.py') }}
+      - uses: pypa/cibuildwheel@v2.23.3
+        env:
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  sdist:
+    needs: [version]
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - run: pipx run build --sdist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  # The Windows installer (Inno Setup) from the Windows wheel, then installed, used and uninstalled.
+  installer:
+    needs: [wheels]
+    runs-on: windows-latest
+    env:
+      SIGNER: ${{ (secrets.SIGNPATH_API_TOKEN != '' && startsWith(github.ref, 'refs/tags/v')) && 'signpath' || 'none' }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels-windows-latest
+          path: wheelhouse
+      - name: Inno Setup
+        run: |
+          $iscc = "${env:ProgramFiles(x86)}\Inno Setup 6\ISCC.exe"
+          if (-not (Test-Path $iscc)) {
+            choco install innosetup -y --no-progress
+            if ($LASTEXITCODE) { exit 1 }
+          }
+          if (-not (Test-Path $iscc)) { Write-Error "ISCC.exe not found after installing Inno Setup"; exit 1 }
+          "ISCC=$iscc" >> $env:GITHUB_ENV
+      - uses: actions/cache@v4
+        with:
+          path: build/installer/downloads
+          key: installer-python-${{ hashFiles('installer/windows/build.py') }}
+      - name: Stage (Python, packages, launchers)
+        run: python installer/windows/build.py stage --wheel-dir wheelhouse --work build/installer
+
+      # --- signing of the programs inside the installer (SIGNER) -----------------------------
+      - name: Collect the programs to sign
+        if: env.SIGNER != 'none'
+        run: |
+          # our own programs only (python.exe and the packages' binaries carry their makers' signatures)
+          $stage = "build/installer/stage/core"
+          $files = @(Get-ChildItem "$stage/bin/*.exe") + @(Get-ChildItem "$stage/python/Scripts/freedyn2*.exe") +
+                   @(Get-ChildItem "$stage/python/Lib/site-packages/fdgen/bin/*.exe")
+          foreach ($f in $files) {
+            $rel = [IO.Path]::GetRelativePath((Resolve-Path $stage), $f.FullName)
+            $dest = Join-Path "build/installer/to-sign" $rel
+            New-Item -ItemType Directory -Force (Split-Path $dest) | Out-Null
+            Copy-Item $f.FullName $dest
+          }
+          Get-ChildItem -Recurse -File build/installer/to-sign | ForEach-Object FullName
+      - name: Upload the programs to sign
+        if: env.SIGNER == 'signpath'
+        id: upload-programs
+        uses: actions/upload-artifact@v4
+        with:
+          name: programs-unsigned
+          path: build/installer/to-sign
+      - name: Sign the programs
+        if: env.SIGNER == 'signpath'
+        uses: signpath/github-action-submit-signing-request@f6d04783b4569d051e0c80105fe66e82819d0092  # v3.0
+        with:
+          api-token: ${{ secrets.SIGNPATH_API_TOKEN }}
+          organization-id: ${{ vars.SIGNPATH_ORGANIZATION_ID }}
+          project-slug: ${{ vars.SIGNPATH_PROJECT_SLUG }}
+          signing-policy-slug: ${{ vars.SIGNPATH_SIGNING_POLICY_SLUG }}
+          artifact-configuration-slug: ${{ vars.SIGNPATH_CONFIG_PROGRAMS }}
+          github-artifact-id: ${{ steps.upload-programs.outputs.artifact-id }}
+          wait-for-completion: true
+          wait-for-completion-timeout-in-seconds: 7200  # release signing waits for a manual approval
+          output-artifact-directory: build/installer/to-sign
+      - name: Put the signed programs into the stage
+        if: env.SIGNER != 'none'
+        run: |
+          Copy-Item -Recurse -Force build/installer/to-sign/* build/installer/stage/core/
+          Get-ChildItem -Recurse -File build/installer/to-sign | ForEach-Object {
+            $s = Get-AuthenticodeSignature $_.FullName
+            "$($s.Status)  $($_.Name)"
+            if ($s.Status -ne 'Valid') { Write-Error "$($_.Name) is not signed"; exit 1 }
+          }
+
+      - name: Installer
+        run: python installer/windows/build.py compile --work build/installer --out dist-installer --iscc "$env:ISCC"
+
+      - name: Upload the installer to sign
+        if: env.SIGNER == 'signpath'
+        id: upload-installer
+        uses: actions/upload-artifact@v4
+        with:
+          name: installer-unsigned
+          path: dist-installer/*.exe
+      - name: Sign the installer
+        if: env.SIGNER == 'signpath'
+        uses: signpath/github-action-submit-signing-request@f6d04783b4569d051e0c80105fe66e82819d0092  # v3.0
+        with:
+          api-token: ${{ secrets.SIGNPATH_API_TOKEN }}
+          organization-id: ${{ vars.SIGNPATH_ORGANIZATION_ID }}
+          project-slug: ${{ vars.SIGNPATH_PROJECT_SLUG }}
+          signing-policy-slug: ${{ vars.SIGNPATH_SIGNING_POLICY_SLUG }}
+          artifact-configuration-slug: ${{ vars.SIGNPATH_CONFIG_INSTALLER }}
+          github-artifact-id: ${{ steps.upload-installer.outputs.artifact-id }}
+          wait-for-completion: true
+          wait-for-completion-timeout-in-seconds: 7200
+          output-artifact-directory: dist-installer
+      - name: Check the signature of the installer
+        if: env.SIGNER != 'none'
+        run: |
+          $s = Get-AuthenticodeSignature (Get-ChildItem dist-installer/FreeDyn2-*-setup.exe)
+          "$($s.Status) $($s.SignerCertificate.Subject)"
+          if ($s.Status -ne 'Valid') { exit 1 }
+
+      # --- smoke test: install silently (per user, into a path with a space), use, uninstall ----
+      - name: Smoke test
+        run: |
+          $ErrorActionPreference = 'Stop'
+          function Check([string]$what) { if ($LASTEXITCODE) { Write-Error "$what failed (exit code $LASTEXITCODE)" } }
+          $setup = (Get-ChildItem dist-installer/FreeDyn2-*-setup.exe | Select-Object -First 1).FullName
+          $dir = Join-Path $env:RUNNER_TEMP 'FreeDyn2 smoke'
+          $log = Join-Path $env:RUNNER_TEMP 'install.log'
+          $p = Start-Process $setup -Wait -PassThru -ArgumentList '/VERYSILENT', '/SUPPRESSMSGBOXES', '/NORESTART', '/CURRENTUSER',
+                 "/DIR=`"$dir`"", '/COMPONENTS=core,compiler,examples', '/TASKS=path', "/LOG=`"$log`""
+          if ($p.ExitCode -ne 0) { Get-Content $log -Tail 50; Write-Error "setup exit code $($p.ExitCode)" }
+          $bin = Join-Path $dir 'bin'
+          foreach ($f in 'bin\freedyn2.exe', 'bin\freedyn2-gui.exe', 'bin\freedyn2-prompt.cmd', 'python\python.exe',
+                         'python\Lib\site-packages\ziglang', 'examples\driven_rotor.yaml', 'licenses\python-packages.txt',
+                         'THIRD-PARTY-NOTICES.txt', 'unins000.exe') {
+            if (-not (Test-Path (Join-Path $dir $f))) { Write-Error "not installed: $f" }
+          }
+          $userPath = (Get-ItemProperty HKCU:\Environment).Path -split ';'
+          if ($userPath -notcontains $bin) { Write-Error "bin not on the user PATH: $userPath" }
+
+          # an isolated user: settings in FREEDYN2_HOME, no CC; the compiler is Zig (component compiler)
+          $env:FREEDYN2_HOME = Join-Path $env:RUNNER_TEMP 'fd2home'
+          Remove-Item Env:CC -ErrorAction SilentlyContinue
+          $work = Join-Path $env:RUNNER_TEMP 'fd2work'
+          New-Item -ItemType Directory -Force $work | Out-Null
+          Set-Location $work
+          $fd = Join-Path $bin 'freedyn2.exe'
+          & $fd --version; Check 'freedyn2 --version'
+          & $fd config compiler zig; Check 'freedyn2 config compiler zig'
+          & $fd doctor; Check 'freedyn2 doctor'
+          & $fd run (Join-Path $dir 'examples\compare\pendulum.fds') -o pendulum.csv; Check 'freedyn2 run pendulum.fds'
+          & $fd run (Join-Path $dir 'examples\driven_rotor.yaml') -o driven_rotor.csv; Check 'freedyn2 run driven_rotor.yaml (Zig)'
+          foreach ($csv in 'pendulum.csv', 'driven_rotor.csv') { if (-not (Test-Path $csv)) { Write-Error "no $csv" } }
+          & $fd setup-mcp --client claude-desktop --dry-run; Check 'freedyn2 setup-mcp --dry-run'
+          # the launcher in python\Scripts works as well (relocated like bin)
+          & (Join-Path $dir 'python\Scripts\freedyn2.exe') --version; Check 'python\Scripts\freedyn2.exe --version'
+
+          Set-Location $env:RUNNER_TEMP
+          $p = Start-Process (Join-Path $dir 'unins000.exe') -Wait -PassThru -ArgumentList '/VERYSILENT', '/SUPPRESSMSGBOXES', '/NORESTART'
+          if ($p.ExitCode -ne 0) { Write-Error "uninstall exit code $($p.ExitCode)" }
+          # the uninstaller continues from a copy in %TEMP%: wait for it
+          for ($i = 0; $i -lt 180 -and (Test-Path $dir); $i++) { Start-Sleep -Seconds 1 }
+          if (Test-Path $dir) { Get-ChildItem -Recurse $dir | Select-Object -First 30 | ForEach-Object FullName; Write-Error "left after uninstall: $dir" }
+          $userPath = (Get-ItemProperty HKCU:\Environment).Path -split ';'
+          if ($userPath -contains $bin) { Write-Error "bin still on the user PATH" }
+          "installed, used and uninstalled"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: installer-windows
+          path: dist-installer/FreeDyn2-*-setup.exe
+          if-no-files-found: error
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [wheels, sdist, installer]
+    runs-on: ubuntu-24.04
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  # GitHub Release vX.Y.Z: wheels, sdist, the installer (also as FreeDyn2-setup.exe for the stable
+  # link .../releases/latest/download/FreeDyn2-setup.exe), SHA256SUMS; notes from CHANGELOG.md
+  # and generated. The app's update notice reads the latest release.
+  release:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [version, wheels, sdist, installer]
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4  # not the unsigned intermediates of the signing
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+      - uses: actions/download-artifact@v4
+        with:
+          name: installer-windows
+          path: dist
+      - name: Assets and notes
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+        run: |
+          cd dist
+          cp "FreeDyn2-$VERSION-setup.exe" FreeDyn2-setup.exe
+          sha256sum -- *.whl *.tar.gz *.exe > SHA256SUMS
+          cat SHA256SUMS
+          cd ..
+          # the section "## [VERSION]" of CHANGELOG.md (empty if there is none)
+          python3 - "$VERSION" > notes.md <<'EOF'
+          import re, sys
+          text = open("CHANGELOG.md", encoding="utf-8").read()
+          m = re.search(rf"^## \[{re.escape(sys.argv[1])}\][^\n]*\n(.*?)(?=^## |\Z)", text, re.M | re.S)
+          print(m.group(1).strip() if m else "")
+          EOF
+          cat notes.md
+      - uses: softprops/action-gh-release@efb35369e0ad2afab669f228072c1b0d510eae64  # v3.0.3
+        with:
+          name: FreeDyn 2 version ${{ needs.version.outputs.version }}
+          body_path: notes.md
+          generate_release_notes: true
+          prerelease: ${{ needs.version.outputs.prerelease == 'true' }}
+          make_latest: ${{ needs.version.outputs.prerelease == 'true' && 'false' || 'true' }}
+          fail_on_unmatched_files: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist/FreeDyn2-*-setup.exe
+            dist/FreeDyn2-setup.exe
+            dist/SHA256SUMS
+
+  # winget (microsoft/winget-pkgs): a pull request with the new version, after the first version was
+  # submitted by hand (installer/winget). Needs the secret WINGET_TOKEN (a classic GitHub token
+  # with public_repo of an account with a fork of winget-pkgs); skipped without it and for pre-releases.
+  winget:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [version, release]
+    runs-on: windows-latest
+    env:
+      HAS_TOKEN: ${{ secrets.WINGET_TOKEN != '' }}
+      PRERELEASE: ${{ needs.version.outputs.prerelease }}
+    steps:
+      - name: Notice
+        if: env.HAS_TOKEN != 'true' || env.PRERELEASE == 'true'
+        run: echo "::notice::winget update skipped (no WINGET_TOKEN, or a pre-release)"
+      - name: wingetcreate update
+        if: env.HAS_TOKEN == 'true' && env.PRERELEASE != 'true'
+        env:
+          WINGET_TOKEN: ${{ secrets.WINGET_TOKEN }}
+          VERSION: ${{ needs.version.outputs.version }}
+        run: |
+          $url = "https://github.com/$env:GITHUB_REPOSITORY/releases/download/v$env:VERSION/FreeDyn2-$env:VERSION-setup.exe"
+          Invoke-WebRequest https://aka.ms/wingetcreate/latest -OutFile wingetcreate.exe
+          # the same installer for both scopes of the manifest (user, machine)
+          .\wingetcreate.exe update FreeDynOrg.FreeDyn2 --version $env:VERSION `
+            --urls "$url|x64|user" "$url|x64|machine" --submit --token $env:WINGET_TOKEN
+          if ($LASTEXITCODE) { exit 1 }

freedyn2-0.1.0rc1/.gitignore

@@ -0,0 +1,15 @@
+build/
+__pycache__/
+*.egg-info/
+.pytest_cache/
+*.csv
+
+# tire data sets (.tir) stay outside the repository (FREEDYN2_TIR)
+*.tir
+
+# documentation: generated live examples, the built site
+docs/live/
+site/
+
+# worktrees of parallel agent sessions
+.claude/worktrees/

freedyn2-0.1.0rc1/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes of FreeDyn 2. Versions follow [semantic versioning](https://semver.org);
+the section of a version becomes the text of its GitHub Release (docs/releasing.md).
+
+## [Unreleased]
+
+## [0.1.0rc1] - 2026-11-06
+
+Release candidate: a test of the release process (PyPI, GitHub Release, Windows installer).
+Not signed yet. Install it explicitly: `pip install --pre freedyn2` or the installer from this
+release.
+
+### Added
+
+- Wheels for Windows (x64) and Linux (x86_64): `pip install freedyn2`, `uv tool install freedyn2`;
+  extras `gui` (app window, pywebview) and `compiler` (Zig, a C compiler for model plugins).
+- Windows installer `FreeDyn2-setup.exe`: per user without administrator rights, its own Python,
+  the app, the command line, optionally Zig, the .fds association and the Claude Desktop setup.
+- The app `freedyn2-gui` / `freedyn2 gui`: start page (open, recent models, examples), a window
+  per model, one instance, an update notice for new releases.
+- `freedyn2 convert`: legacy .fds models as YAML model files.
+- The Python API: `import freedyn2` (load, run, check, sweep, convert).
+- `freedyn2 setup-mcp`, `freedyn2 doctor`, `freedyn2 config`, `freedyn2 update-check`.
+- Compiler selection: Zig, MSVC without a developer prompt (vswhere), gcc, clang.
+
+## [0.1.0] - unreleased
+
+First release.
+
+### Added
+
+- Wheels for Windows (x64) and Linux (x86_64) on PyPI: `pip install freedyn2`, `uv tool install freedyn2`.
+- Windows installer `FreeDyn2-setup.exe` (per user, no administrator rights): its own Python, the
+  app, the viewer, the MCP server and optionally a C compiler (Zig) for model plugins.
+- ...

freedyn2-0.1.0rc1/CITATION.cff

@@ -0,0 +1,78 @@
+cff-version: 1.2.0
+message: "If you use FreeDyn 2, please cite it with these metadata."
+title: "FreeDyn 2: multibody dynamics with generated models"
+type: software
+authors:
+  - family-names: Oberpeilsteiner
+    given-names: Stefan
+  - name: "The FreeDyn 2 contributors"
+repository-code: "https://github.com/freedyn-org/freedyn2"
+url: "https://freedyn-org.github.io/freedyn2/"
+license: Apache-2.0
+keywords:
+  - multibody dynamics
+  - HHT
+  - Lie group time integration
+  - CasADi
+  - code generation
+references:
+  - type: conference-paper
+    title: "FreeDyn: a free, flexible and state of the art multibody simulation package for education, research and industrial applications"
+    authors:
+      - family-names: Witteveen
+        given-names: Wolfgang
+      - family-names: Lauss
+        given-names: Thomas
+      - family-names: Oberpeilsteiner
+        given-names: Stefan
+    collection-title: "Nonlinear Structures & Systems, Volume 1"
+    publisher:
+      name: Springer
+    year: 2021
+    doi: "10.1007/978-3-030-47626-7_8"
+  - type: conference-paper
+    title: "FreeDyn: a multibody simulation research code"
+    authors:
+      - family-names: Nachbagauer
+        given-names: Karin
+      - family-names: Sherif
+        given-names: Karim
+      - family-names: Witteveen
+        given-names: Wolfgang
+    conference:
+      name: "11th World Congress on Computational Mechanics (WCCM XI), 5th European Conference on Computational Mechanics (ECCM V)"
+      city: Barcelona
+    year: 2014
+  - type: conference-paper
+    title: "FreeDyn: a software for advanced multibody simulation: applications in the field of vehicle dynamics"
+    authors:
+      - family-names: Oberpeilsteiner
+        given-names: Stefan
+      - family-names: Lauss
+        given-names: Thomas
+      - family-names: Eichmeir
+        given-names: Philipp
+      - family-names: Steiner
+        given-names: Wolfgang
+    conference:
+      name: "ECCOMAS Thematic Conference on Multibody Dynamics 2019"
+      city: Duisburg
+    year: 2019
+  - type: article
+    title: "A modified HHT method for the numerical simulation of rigid body rotations with Euler parameters"
+    authors:
+      - family-names: Sherif
+        given-names: Karim
+      - family-names: Nachbagauer
+        given-names: Karin
+      - family-names: Steiner
+        given-names: Wolfgang
+      - family-names: Lauss
+        given-names: Thomas
+    journal: "Multibody System Dynamics"
+    volume: 46
+    issue: 2
+    start: 181
+    end: 202
+    year: 2019
+    doi: "10.1007/s11044-019-09672-6"

freedyn2-0.1.0rc1/CLAUDE.md

@@ -0,0 +1,9 @@
+# Notes for Claude
+
+## Brand
+
+Anything visual or public-facing (viewer UI, docs theme, README, slides, release notes, social
+images) follows [`brand/README.md`](brand/README.md): name always `freedyn2` in lower case, claim
+"ai-first multibody dynamics.", colors and fonts from [`brand/tokens.json`](brand/tokens.json)
+(CSS: [`brand/tokens.css`](brand/tokens.css)), logos from [`brand/logo/`](brand/logo/). Do not
+invent new colors or logo variants; extend the tokens instead.