Normalize build, CI/CD, and centralized versioning

.github/workflows/distribution-validation.yaml

@@ -0,0 +1,53 @@
+name: distribution-validation
+on:
+  workflow_dispatch:
+    inputs:
+      configuration:
+        description: Build configuration
+        required: true
+        default: Release
+        type: choice
+        options: [Debug, Staging, Release]
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+permissions:
+  contents: read
+env:
+  DOTNET_VERSION: 10.0.x
+jobs:
+  metadata:
+    runs-on: ubuntu-latest
+    outputs:
+      has_solution: ${{ steps.repository.outputs.has_solution }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      - id: repository
+        shell: pwsh
+        run: ./packaging/Get-RepositoryMetadata.ps1 -Configuration '${{ inputs.configuration }}' -GitHubOutputPath $env:GITHUB_OUTPUT
+  validate:
+    needs: metadata
+    if: needs.metadata.outputs.has_solution == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { os: windows-latest, name: Windows x64 }
+          - { os: windows-11-arm, name: Windows ARM64 }
+          - { os: ubuntu-24.04, name: Linux x64 }
+          - { os: ubuntu-24.04-arm, name: Linux ARM64 }
+          - { os: macos-15-intel, name: macOS x64 }
+          - { os: macos-15, name: macOS ARM64 }
+    name: ${{ matrix.name }}
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      - name: Verify distribution
+        shell: pwsh
+        run: ./packaging/VerifyDistribution.ps1 -Configuration '${{ inputs.configuration }}'

.github/workflows/main.yaml

@@ -0,0 +1,48 @@
+name: main
+on:
+  push:
+    branches: [main]
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+permissions:
+  contents: read
+env:
+  DOTNET_VERSION: 10.0.x
+  CONFIGURATION: Release
+jobs:
+  metadata:
+    runs-on: ubuntu-latest
+    outputs:
+      has_solution: ${{ steps.repository.outputs.has_solution }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      - id: repository
+        shell: pwsh
+        run: ./packaging/Get-RepositoryMetadata.ps1 -Configuration '${{ env.CONFIGURATION }}' -GitHubOutputPath $env:GITHUB_OUTPUT
+  validate:
+    needs: metadata
+    if: needs.metadata.outputs.has_solution == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { os: windows-latest, name: Windows x64 }
+          - { os: windows-11-arm, name: Windows ARM64 }
+          - { os: ubuntu-24.04, name: Linux x64 }
+          - { os: ubuntu-24.04-arm, name: Linux ARM64 }
+          - { os: macos-15-intel, name: macOS x64 }
+          - { os: macos-15, name: macOS ARM64 }
+    name: ${{ matrix.name }}
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      - name: Verify Release distribution
+        shell: pwsh
+        run: ./packaging/VerifyDistribution.ps1 -Configuration '${{ env.CONFIGURATION }}'

.github/workflows/pull-request.yaml

@@ -0,0 +1,90 @@
+name: pull-request
+
+on:
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  DOTNET_VERSION: 10.0.x
+  CONFIGURATION: Staging
+
+jobs:
+  metadata:
+    runs-on: ubuntu-latest
+    outputs:
+      has_solution: ${{ steps.repository.outputs.has_solution }}
+      solution_path: ${{ steps.repository.outputs.solution_path }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      - id: repository
+        shell: pwsh
+        run: >-
+          ./packaging/Get-RepositoryMetadata.ps1
+          -Configuration '${{ env.CONFIGURATION }}'
+          -GitHubOutputPath $env:GITHUB_OUTPUT
+
+  validate:
+    needs: metadata
+    if: needs.metadata.outputs.has_solution == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            name: Windows
+            verify_packages: false
+          - os: ubuntu-latest
+            name: Linux
+            verify_packages: true
+          - os: macos-latest
+            name: macOS
+            verify_packages: false
+    name: ${{ matrix.name }}
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      - name: Restore
+        run: dotnet restore '${{ needs.metadata.outputs.solution_path }}'
+      - name: Build
+        run: >-
+          dotnet build '${{ needs.metadata.outputs.solution_path }}'
+          -c ${{ env.CONFIGURATION }}
+          --no-restore
+          -p:ContinuousIntegrationBuild=true
+      - name: Test
+        run: >-
+          dotnet test '${{ needs.metadata.outputs.solution_path }}'
+          -c ${{ env.CONFIGURATION }}
+          --no-build
+          --no-restore
+          --logger trx
+      - name: Pack Staging artifacts
+        if: matrix.verify_packages
+        run: >-
+          dotnet pack '${{ needs.metadata.outputs.solution_path }}'
+          -c ${{ env.CONFIGURATION }}
+          --no-build
+          --no-restore
+          -o artifacts
+          -p:ContinuousIntegrationBuild=true
+      - name: Verify exact Staging package artifacts
+        if: matrix.verify_packages
+        shell: pwsh
+        run: >-
+          ./packaging/VerifyPackageArtifact.ps1
+          -ArtifactDirectory artifacts
+          -Configuration '${{ env.CONFIGURATION }}'
+          -ExpectedPackageId 'Icod.UtilLinux.Tools'
+          -ExpectedPackageCount 1