build: Directory.Build.props for centralised SAMVersion stamping

.github/workflows/build.yml

@@ -2,9 +2,9 @@ name: Build (Windows)
 
 on:
  push:
- branches: [ "master", "main" ]
+ branches: [ "master", "main", "sow/**" ]
  pull_request:
- branches: [ "master", "main" ]
+ branches: [ "master", "main", "sow/**" ]
  workflow_dispatch:
 
 jobs:
@@ -35,6 +35,36 @@ jobs:
 
  - name: Setup MSBuild
  uses: microsoft/setup-msbuild@v2
+ - name: Compute SAMVersion
+ id: ver
+ shell: pwsh
+ run: |
+ $ErrorActionPreference = 'Stop'
+ # Prefer head_ref when its a sow branch (release-promotion PRs from sow/* to main),
+ # else use base_ref on PR events / ref_name on push events.
+ $headRef = '${{ github.head_ref }}'
+ $baseRef = '${{ github.base_ref }}'
+ $refName = '${{ github.ref_name }}'
+ if ($headRef -match '^sow/\d{4}-Q\d$') {
+ $ref = $headRef
+ } elseif ('${{ github.event_name }}' -eq 'pull_request') {
+ $ref = $baseRef
+ } else {
+ $ref = $refName
+ }
+ # .NET AssemblyVersion components are UInt16 (max 65535). Cap to 60000 for headroom.
+ $run = ${{ github.run_number }} % 60000
+ if ($ref -match 'sow/(\d{4})-Q(\d)') {
+ $v = "$($Matches[1]).$($Matches[2]).$run.0"
+ $src = "branch '$ref'"
+ } else {
+ $now = (Get-Date).ToUniversalTime()
+ $quarter = [int][Math]::Ceiling($now.Month / 3.0)
+ $v = "$($now.Year).$quarter.$run.0"
+ $src = "date $($now.ToString('yyyy-MM-dd')) (ref '$ref' not sow/yyyy-Qx)"
+ }
+ Write-Host "SAMVersion = $v (from $src)"
+ "samversion=$v" | Out-File -FilePath $env:GITHUB_OUTPUT -Append -Encoding utf8
 
  - name: Clone dependency repos (siblings)
  shell: pwsh
@@ -52,10 +82,32 @@ jobs:
 
  # Clone everything except the last one (already checked out by Actions)
  $deps = $buildOrder[0..($buildOrder.Count-2)]
+ # Branch resolution: prefer PR head_ref, then current sow branch, then sow/2026-Q2 fallback.
+ $headRef = '${{ github.head_ref }}'
+ $baseRef = '${{ github.base_ref }}'
+ $refName = '${{ github.ref_name }}'
+ $candidates = @()
+ if ($headRef) { $candidates += $headRef }
+ $sowRef = if ($baseRef -match '^sow/') { $baseRef } elseif ($refName -match '^sow/') { $refName } else { '' }
+ if ($sowRef -and $sowRef -ne $headRef) { $candidates += $sowRef }
+ $candidates += 'sow/2026-Q2'
+
  foreach ($r in $deps) {
  if (Test-Path $r) { continue }
- Write-Host "Cloning https://github.com/$org/$r.git"
- git clone --depth 1 "https://github.com/$org/$r.git" $r
+ $cloned = $false
+ foreach ($cand in $candidates) {
+ $has = (git ls-remote --heads "https://github.com/$org/$r.git" $cand 2>$null | Out-String).Trim()
+ if ($has) {
+ Write-Host "Cloning $org/$r @ $cand"
+ git clone --depth 1 --branch $cand "https://github.com/$org/$r.git" $r
+ $cloned = $true
+ break
+ }
+ }
+ if (-not $cloned) {
+ Write-Host "Cloning $org/$r @ default branch"
+ git clone --depth 1 "https://github.com/$org/$r.git" $r
+ }
  }
 
  # Ensure ReferencePath exists even before SAM_Windows builds
@@ -76,6 +128,7 @@ jobs:
  '/v:m'
  '/p:Configuration=Release'
  '/p:UseSharedCompilation=false'
+ '/p:SAMVersion=${{ steps.ver.outputs.samversion }}'
  '/p:RunPostBuildEvent=OnOutputUpdated'
  "/p:ReferencePath=$windowsRef"
  )

Application/SAM Analytical/AssemblyInfo.cs

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Copyright (c) 2020–2026 Michal Dengusiak & Jakub Ziolkowski and contributors
+
 using System.Windows;
 
 [assembly: ThemeInfo(

Directory.Build.props

@@ -0,0 +1,39 @@
+<Project>
+
+ <PropertyGroup>
+ <!-- Local dev builds default to 1.0.0.0. CI passes /p:SAMVersion=YYYY.Q.<run_number>. -->
+ <SAMVersion Condition="'$(SAMVersion)' == ''">1.0.0.0</SAMVersion>
+ <AssemblyVersion>$(SAMVersion)</AssemblyVersion>
+ <FileVersion>$(SAMVersion)</FileVersion>
+ <Deterministic>true</Deterministic>
+ </PropertyGroup>
+
+ <!--
+ Projects where SDK assembly-attribute generation is disabled (legacy AssemblyInfo.cs
+ with GenerateAssemblyInfo=false) OR projects where the SDK doesn't auto-generate
+ attributes at all (classic-style csprojs that don't set the property — '' evaluates
+ as not 'true') ignore the AssemblyVersion/FileVersion MSBuild properties above.
+ Inject the attributes via a generated source file so those assemblies also get
+ stamped by CI.
+ -->
+ <Target Name="_GenerateSAMVersionFile"
+ BeforeTargets="CoreCompile"
+ Condition="'$(GenerateAssemblyInfo)' != 'true'">
+ <ItemGroup>
+ <_SAMVersionLine Include="// &lt;auto-generated /&gt;" />
+ <_SAMVersionLine Include="[assembly: System.Reflection.AssemblyVersionAttribute(&quot;$(SAMVersion)&quot;)]" />
+ <_SAMVersionLine Include="[assembly: System.Reflection.AssemblyFileVersionAttribute(&quot;$(SAMVersion)&quot;)]" />
+ </ItemGroup>
+ <MakeDir Directories="$(IntermediateOutputPath)" />
+ <WriteLinesToFile
+ File="$(IntermediateOutputPath)SAMVersion.g.cs"
+ Lines="@(_SAMVersionLine)"
+ Overwrite="true"
+ WriteOnlyWhenDifferent="true" />
+ <ItemGroup>
+ <Compile Include="$(IntermediateOutputPath)SAMVersion.g.cs" KeepDuplicates="false" />
+ <FileWrites Include="$(IntermediateOutputPath)SAMVersion.g.cs" />
+ </ItemGroup>
+ </Target>
+
+</Project>