Add CI/CD workflows for building and releasing single-file executables

Author: sylvain-guillet

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [ "**" ]
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "9.0.x"
+
+      - name: Restore
+        run: dotnet restore
+
+      - name: Build (Release)
+        run: dotnet build --no-restore -c Release

.github/workflows/release.yml

@@ -0,0 +1,68 @@
+name: Release single-file (server.Stdio)
+
+on:
+  workflow_dispatch:
+    inputs:
+      rid:
+        description: ".NET Runtime Identifier (e.g., linux-x64, win-x64, osx-arm64)"
+        required: true
+        default: "linux-x64"
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: "9.0.x"
+
+      # Note:
+      # - You can cross-publish for other OSes on ubuntu-latest by changing RID (e.g., win-x64, osx-arm64).
+      # - macOS binaries produced here are unsigned; signing/notarization must be performed on macOS.
+      - name: Publish single-file
+        id: publish
+        shell: bash
+        env:
+          RID: ${{ github.event.inputs.rid || 'linux-x64' }}
+        run: |
+          set -euo pipefail
+          PROJ="Server.Stdio/Server.Stdio.csproj"
+          echo "Publishing $PROJ for RID=$RID"
+
+          dotnet publish "$PROJ" -c Release -r "$RID" \
+            -p:PublishSingleFile=true \
+            -p:SelfContained=true \
+            -p:PublishTrimmed=false
+
+          TF=$(dotnet msbuild "$PROJ" -getproperty:TargetFramework -nologo -v:quiet)
+          PUB_DIR="$(dirname "$PROJ")/bin/Release/${TF}/${RID}/publish"
+          echo "publish_dir=$PUB_DIR" >> "$GITHUB_OUTPUT"
+          echo "Publish dir: $PUB_DIR"
+
+          if [[ "$RID" == win* ]]; then
+            EXE=$(find "$PUB_DIR" -maxdepth 1 -type f -name "*.exe" | head -n1 || true)
+          else
+            EXE=$(find "$PUB_DIR" -maxdepth 1 -type f -perm -u+x | head -n1 || true)
+          fi
+
+          if [ -z "$EXE" ]; then
+            echo "No executable found in $PUB_DIR" >&2
+            ls -la "$PUB_DIR" || true
+            exit 1
+          fi
+          echo "exe=$EXE" >> "$GITHUB_OUTPUT"
+          echo "Executable: $EXE"
+
+      - name: Upload executable artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: io-aerosapce-mcp-${{ github.ref_name }}-${{ github.event.inputs.rid || 'linux-x64' }}
+          path: ${{ steps.publish.outputs.exe }}
+          if-no-files-found: error

docs/CI-CD.md

@@ -0,0 +1,29 @@
+# CI/CD
+
+- CI: Builds the repository on every push and PR (.github/workflows/ci.yml).
+- CD: Publishes a single-file executable for `server.Stdio` and uploads only that file as an artifact (.github/workflows/release.yml).
+
+How to trigger deployment:
+- Tag-based: push a tag like `v1.0.0`.
+- Manual: Actions → "Release single-file (server.Stdio)" → Run workflow and choose a RID (default `linux-x64`).
+
+Change target runtime:
+- Provide a different RID when running the workflow (examples: `linux-x64`, `win-x64`, `osx-arm64`).
+
+Result:
+- Artifact name: `io-aerosapce-mcp-<tag or branch>-<RID>`
+- Contains only the produced executable.
+
+Note on cross-publishing (ubuntu-latest):
+- Yes, you can generate Windows (.exe) or macOS binaries from Ubuntu by setting RID to `win-x64` or `osx-arm64`.
+- macOS outputs will be unsigned; signing/notarization must happen on macOS if required.
+
+Local single-file publish examples:
+```bash
+# Linux
+dotnet publish ./Server.Stdio/Server.Stdio.csproj -c Release -r linux-x64 -p:PublishSingleFile=true -p:SelfContained=true
+# Windows
+dotnet publish ./Server.Stdio/Server.Stdio.csproj -c Release -r win-x64   -p:PublishSingleFile=true -p:SelfContained=true
+# macOS (unsigned)
+dotnet publish ./Server.Stdio/Server.Stdio.csproj -c Release -r osx-arm64 -p:PublishSingleFile=true -p:SelfContained=true
+```