sow/2026-Q3: SAM-BIM Q3 2026 updates

.gitattributes

@@ -0,0 +1,4 @@
+# The benchmark producer golden fixtures are asserted byte-for-byte against the serializer
+# output, which is UTF-8 without BOM and uses LF newlines. Pin them to LF so Git's autocrlf
+# setting cannot rewrite them to CRLF on checkout and break the byte-stability comparison.
+benchmark/**/*.json text eol=lf

.github/workflows/build.yml

@@ -89,6 +89,62 @@ jobs:
             # Current sow branch: base_ref on PR events, ref_name on push events.
             $sowRef = if ($baseRef -match '^sow/') { $baseRef } elseif ($refName -match '^sow/') { $refName } else { '' }
             if ($sowRef -and $sowRef -ne $headRef) { $candidates += $sowRef }
+            # Feature branches off a quarterly sow branch (e.g. sow/2026-Q3-feature): the
+            # quarter branch itself carries the matching dependency state. Without this a
+            # push-event build (no head/base ref) falls straight to the stale fallback below.
+            # NOTE: the loop variable must NOT be $r — that is the outer repo-name variable.
+            foreach ($branchRef in @($headRef, $baseRef, $refName)) {
+              if ($branchRef -match '^sow/(\d{4}-Q\d)') {
+                $quarterRef = "sow/$($Matches[1])"
+                if ($candidates -notcontains $quarterRef) { $candidates += $quarterRef }
+              }
+            }
+            $candidates += 'sow/2026-Q2'
+            $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
+            }
+          }
+
+
+      - name: Build benchmark schema (SAM_Validation)
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = 'Stop'
+
+          $org = '${{ env.ORG_NAME }}'
+          $r   = 'SAM_Validation'
+
+          # Clone SAM_Validation as a sibling (same branch-candidate fallback as the deps step
+          # above), then build ONLY the engine-neutral benchmark schema (B1a) into its build\
+          # folder. The B1b producer references it by HintPath
+          # (..\..\..\SAM_Validation\build\SAM.Analytical.Benchmark.dll), so it must exist before
+          # SAM_OpenStudio is built below. The schema project is standalone (netstandard2.0,
+          # System.Text.Json only) — no other SAM_Validation project is built.
+          if (-not (Test-Path $r)) {
+            $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 }
+            foreach ($branchRef in @($headRef, $baseRef, $refName)) {
+              if ($branchRef -match '^sow/(\d{4}-Q\d)') {
+                $quarterRef = "sow/$($Matches[1])"
+                if ($candidates -notcontains $quarterRef) { $candidates += $quarterRef }
+              }
+            }
             $candidates += 'sow/2026-Q2'
             $cloned = $false
             foreach ($cand in $candidates) {
@@ -106,6 +162,14 @@ jobs:
             }
           }
 
+          $csproj = Join-Path $r 'SAM.Analytical.Benchmark/SAM.Analytical.Benchmark.csproj'
+          Write-Host "==> Building benchmark schema: $csproj"
+          & dotnet build $csproj -c Release '/p:SAMVersion=${{ steps.ver.outputs.samversion }}'
+          if ($LASTEXITCODE -ne 0) { throw "Benchmark schema build failed" }
+
+          $dll = Join-Path $r 'build/SAM.Analytical.Benchmark.dll'
+          if (-not (Test-Path $dll)) { throw "Expected schema DLL missing after build: $dll" }
+          Write-Host "Schema DLL present: $dll"
 
       - name: Restore + Rebuild in order (safe Platform handling)
         shell: pwsh
@@ -188,6 +252,27 @@ jobs:
             if ($LASTEXITCODE -ne 0) { throw "Rebuild failed: $($it.Repo)" }
           }
 
+      - name: Run benchmark producer tests (offline)
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = 'Stop'
+
+          $repo = '${{ env.REPO_NAME }}'
+
+          # Run the portable B1b producer tests: the C5 -> B1a mapping, the committed golden
+          # JSON byte-stability check and the CLI contract tests. The single live end-to-end
+          # test is [Category("Simulation")] and is excluded here (it needs an OpenStudio/
+          # EnergyPlus install); it remains available for an environment-gated run.
+          $testProject = Join-Path $repo 'benchmark/SAM.Analytical.OpenStudio.Benchmark.Tests/SAM.Analytical.OpenStudio.Benchmark.Tests.csproj'
+          Write-Host "==> Testing (excluding Simulation): $testProject"
+          & dotnet test $testProject `
+            -c Release `
+            '/p:Platform=x64' `
+            '/p:SAMVersion=${{ steps.ver.outputs.samversion }}' `
+            --filter 'TestCategory!=Simulation' `
+            --logger 'console;verbosity=normal'
+          if ($LASTEXITCODE -ne 0) { throw "Benchmark producer tests failed" }
+
       - name: Upload build folders (optional)
         uses: actions/upload-artifact@v4
         with:

Grasshopper/SAM.Analytical.Grasshopper.OpenStudio/Component/MenuHelper.cs

@@ -0,0 +1,64 @@
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Copyright (c) 2020–2026 Michal Dengusiak & Jakub Ziolkowski and contributors
+
+using Grasshopper.Kernel;
+using Grasshopper.Kernel.Types;
+using System.Linq;
+
+namespace SAM.Analytical.Grasshopper.OpenStudio
+{
+    /// <summary>
+    /// Shared helpers for the "Go to Directory" context-menu item (same behaviour as
+    /// SAMAnalytical.Paths in the SAM repository): the path is read from the volatile data
+    /// of an input parameter and opened in Windows Explorer.
+    /// </summary>
+    internal static class MenuHelper
+    {
+        internal static string GetVolatileString(GH_Component component, string name)
+        {
+            int index = component.Params.IndexOfInputParam(name);
+            if (index == -1)
+            {
+                return null;
+            }
+
+            object @object = component.Params.Input[index].VolatileData.AllData(true)?.OfType<object>()?.FirstOrDefault();
+            if (@object is IGH_Goo)
+            {
+                return (@object as dynamic).Value?.ToString();
+            }
+
+            return null;
+        }
+
+        internal static void GoToDirectory(string directory, bool create)
+        {
+            if (string.IsNullOrWhiteSpace(directory))
+            {
+                return;
+            }
+
+            if (create)
+            {
+                Core.Create.Directory(directory);
+            }
+
+            if (!System.IO.Directory.Exists(directory))
+            {
+                return;
+            }
+
+            Core.Query.StartProcess(directory);
+        }
+
+        internal static void GoToFileDirectory(string path)
+        {
+            if (string.IsNullOrWhiteSpace(path) || !System.IO.File.Exists(path))
+            {
+                return;
+            }
+
+            GoToDirectory(System.IO.Path.GetDirectoryName(path), false);
+        }
+    }
+}

Grasshopper/SAM.Analytical.Grasshopper.OpenStudio/Component/OpenStudioCreateDesignDaysBySQL.cs

@@ -1,11 +1,15 @@
-using Grasshopper.Kernel;
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Copyright (c) 2020–2026 Michal Dengusiak & Jakub Ziolkowski and contributors
+
+using Grasshopper.Kernel;
 using SAM.Core.Grasshopper;
 using System;
 using System.Collections.Generic;
+using System.Windows.Forms;
 
 namespace SAM.Analytical.Grasshopper.OpenStudio
 {
-    public class OpenStudioCreateDesignDaysBySQL : GH_SAMComponent
+    public class OpenStudioCreateDesignDaysBySQL : GH_SAMVariableOutputParameterComponent
     {
         /// <summary>
         /// Gets the unique ID for this component. Do not change this ID after release.
@@ -15,7 +19,7 @@ public class OpenStudioCreateDesignDaysBySQL : GH_SAMComponent
         /// <summary>
         /// The latest version of this component
         /// </summary>
-        public override string LatestComponentVersion => "1.0.0";
+        public override string LatestComponentVersion => "1.0.3";
 
         /// <summary>
         /// Provides an Icon for the component.
@@ -32,20 +36,43 @@ public OpenStudioCreateDesignDaysBySQL()
         {
         }
 
+        public override void AppendAdditionalMenuItems(ToolStripDropDown menu)
+        {
+            base.AppendAdditionalMenuItems(menu);
+
+            Menu_AppendSeparator(menu);
+            Menu_AppendItem(menu, "Go to Directory", Menu_GoToDirectory, Properties.Resources.SAM_Small, true, false);
+        }
+
+        void Menu_GoToDirectory(object sender, EventArgs e)
+        {
+            MenuHelper.GoToFileDirectory(MenuHelper.GetVolatileString(this, "_sQLPath"));
+        }
+
         /// <summary>
         /// Registers all the input parameters for this component.
         /// </summary>
-        protected override void RegisterInputParams(GH_InputParamManager inputParamManager)
+        protected override GH_SAMParam[] Inputs
         {
-            inputParamManager.AddTextParameter("_sQLPath", "_sQLPath", "SQL File Path", GH_ParamAccess.item);
+            get
+            {
+                List<GH_SAMParam> result = new List<GH_SAMParam>();
+                result.Add(new GH_SAMParam(new global::Grasshopper.Kernel.Parameters.Param_String() { Name = "_sQLPath", NickName = "_sQLPath", Description = "SQL File Path", Access = GH_ParamAccess.item }, ParamVisibility.Binding));
+                return result.ToArray();
+            }
         }
 
         /// <summary>
         /// Registers all the output parameters for this component.
         /// </summary>
-        protected override void RegisterOutputParams(GH_OutputParamManager outputParamManager)
+        protected override GH_SAMParam[] Outputs
         {
-            outputParamManager.AddParameter(new GooAnalyticalObjectParam(), "designDays", "designDays", "SAM Analytical DesignDays", GH_ParamAccess.list);
+            get
+            {
+                List<GH_SAMParam> result = new List<GH_SAMParam>();
+                result.Add(new GH_SAMParam(new GooAnalyticalObjectParam() { Name = "designDays", NickName = "designDays", Description = "SAM Analytical DesignDays", Access = GH_ParamAccess.list }, ParamVisibility.Binding));
+                return result.ToArray();
+            }
         }
 
         /// <summary>
@@ -55,15 +82,38 @@ protected override void RegisterOutputParams(GH_OutputParamManager outputParamMa
         protected override void SolveInstance(IGH_DataAccess dataAccess)
         {
             string path = null;
-            if (!dataAccess.GetData(0, ref path) || path == null)
+            int index = Params.IndexOfInputParam("_sQLPath");
+            if (index == -1 || !dataAccess.GetData(index, ref path) || path == null)
             {
                 AddRuntimeMessage(GH_RuntimeMessageLevel.Error, "Invalid data");
                 return;
             }
 
-            List<DesignDay> result = Analytical.OpenStudio.Create.DesignDays(path);
+            List<DesignDay> result = null;
+            List<string> diagnostics = null;
+            try
+            {
+                result = Analytical.OpenStudio.Create.DesignDays(path, out diagnostics);
+            }
+            catch (Exception exception)
+            {
+                // Malformed SQL content is a structured diagnostic, never a solution exception.
+                AddRuntimeMessage(GH_RuntimeMessageLevel.Warning, string.Format("Design days could not be read: {0}", exception.Message));
+            }
+
+            if (diagnostics != null)
+            {
+                foreach (string diagnostic in diagnostics)
+                {
+                    AddRuntimeMessage(GH_RuntimeMessageLevel.Warning, diagnostic);
+                }
+            }
 
-            dataAccess.SetDataList(0, result);
+            index = Params.IndexOfOutputParam("designDays");
+            if (index != -1)
+            {
+                dataAccess.SetDataList(index, result);
+            }
         }
     }
-}
+}

Grasshopper/SAM.Analytical.Grasshopper.OpenStudio/Component/OpenStudioCreateSpaceSimulationResultsBySQL.cs

@@ -1,10 +1,15 @@
-using Grasshopper.Kernel;
+// SPDX-License-Identifier: LGPL-3.0-or-later
+// Copyright (c) 2020–2026 Michal Dengusiak & Jakub Ziolkowski and contributors
+
+using Grasshopper.Kernel;
 using SAM.Core.Grasshopper;
 using System;
+using System.Collections.Generic;
+using System.Windows.Forms;
 
 namespace SAM.Analytical.Grasshopper.OpenStudio
 {
-    public class OpenStudioCreateSpaceSimulationResultsBySQL : GH_SAMComponent
+    public class OpenStudioCreateSpaceSimulationResultsBySQL : GH_SAMVariableOutputParameterComponent
     {
         /// <summary>
         /// Gets the unique ID for this component. Do not change this ID after release.
@@ -14,7 +19,7 @@ public class OpenStudioCreateSpaceSimulationResultsBySQL : GH_SAMComponent
         /// <summary>
         /// The latest version of this component
         /// </summary>
-        public override string LatestComponentVersion => "1.0.1";
+        public override string LatestComponentVersion => "1.0.3";
 
         /// <summary>
         /// Provides an Icon for the component.
@@ -31,20 +36,43 @@ public OpenStudioCreateSpaceSimulationResultsBySQL()
         {
         }
 
+        public override void AppendAdditionalMenuItems(ToolStripDropDown menu)
+        {
+            base.AppendAdditionalMenuItems(menu);
+
+            Menu_AppendSeparator(menu);
+            Menu_AppendItem(menu, "Go to Directory", Menu_GoToDirectory, Properties.Resources.SAM_Small, true, false);
+        }
+
+        void Menu_GoToDirectory(object sender, EventArgs e)
+        {
+            MenuHelper.GoToFileDirectory(MenuHelper.GetVolatileString(this, "_sQLPath"));
+        }
+
         /// <summary>
         /// Registers all the input parameters for this component.
         /// </summary>
-        protected override void RegisterInputParams(GH_InputParamManager inputParamManager)
+        protected override GH_SAMParam[] Inputs
         {
-            inputParamManager.AddTextParameter("_sQLPath", "_sQLPath", "SQL File Path", GH_ParamAccess.item);
+            get
+            {
+                List<GH_SAMParam> result = new List<GH_SAMParam>();
+                result.Add(new GH_SAMParam(new global::Grasshopper.Kernel.Parameters.Param_String() { Name = "_sQLPath", NickName = "_sQLPath", Description = "SQL File Path", Access = GH_ParamAccess.item }, ParamVisibility.Binding));
+                return result.ToArray();
+            }
         }
 
         /// <summary>
         /// Registers all the output parameters for this component.
         /// </summary>
-        protected override void RegisterOutputParams(GH_OutputParamManager outputParamManager)
+        protected override GH_SAMParam[] Outputs
         {
-            outputParamManager.AddParameter(new GooResultParam(), "spaceSymulationResults", "spaceSymulationResults", "SAM Analytical SpaceSimulationResults", GH_ParamAccess.list);
+            get
+            {
+                List<GH_SAMParam> result = new List<GH_SAMParam>();
+                result.Add(new GH_SAMParam(new GooResultParam() { Name = "spaceSymulationResults", NickName = "spaceSymulationResults", Description = "SAM Analytical SpaceSimulationResults", Access = GH_ParamAccess.list }, ParamVisibility.Binding));
+                return result.ToArray();
+            }
         }
 
         /// <summary>
@@ -55,13 +83,18 @@ protected override void SolveInstance(IGH_DataAccess dataAccess)
         {
             string path = null;
 
-            if (!dataAccess.GetData(0, ref path) || path == null)
+            int index = Params.IndexOfInputParam("_sQLPath");
+            if (index == -1 || !dataAccess.GetData(index, ref path) || path == null)
             {
                 AddRuntimeMessage(GH_RuntimeMessageLevel.Error, "Invalid data");
                 return;
             }
 
-            dataAccess.SetDataList(0, Analytical.OpenStudio.Create.SpaceSimulationResults(path)?.ConvertAll(x => new GooResult(x)));
+            index = Params.IndexOfOutputParam("spaceSymulationResults");
+            if (index != -1)
+            {
+                dataAccess.SetDataList(index, Analytical.OpenStudio.Create.SpaceSimulationResults(path)?.ConvertAll(x => new GooResult(x)));
+            }
         }
     }
-}
+}