Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Qualify Apple Silicon numeric snapshots and isolate native publication
Yuechen Liab1614172c37
diff --git a/.github/workflows/portable-release.yml b/.github/workflows/portable-release.ymlindex ab0ed0b2..f1fd6dc1 100644--- a/.github/workflows/portable-release.yml+++ b/.github/workflows/portable-release.yml@@ -67,6 +67,15 @@ jobs:[xml]$props = Get-Content artifacts/local/product-source/Directory.Build.props$version = [string]$props.Project.PropertyGroup.Version"PRODUCT_VERSION=$version" >> $env:GITHUB_ENV+ # Qualify with current platform tests, but package the immutable product+ # ref. Permit test/tooling maintenance, never different production code.+ $revision = (git -C artifacts/local/product-source rev-parse HEAD).Trim()+ git fetch origin $revision --depth=1+ $changes = @(git diff --name-only $revision HEAD)+ $productionChanges = @($changes | Where-Object {+ $_ -notmatch '^(docs/|scripts/|\.github/|Aetheris\.Kernel\.Core\.Tests/|testdata/step242/manifests/|README\.md$)'+ })+ if ($productionChanges.Count) { throw "Qualification and product code differ: $($productionChanges -join ', ')" }if ($env:FRONTEND_RUN) {gh run download $env:FRONTEND_RUN --name aetheris-release --dir artifacts/local/reference} else {@@ -77,17 +86,6 @@ jobs:$expected = Get-Content artifacts/local/reference/SHA256SUMS.txt | Where-Object { $_.EndsWith(" $($archive.Name)") }if ($expected -ne "$( (Get-FileHash $archive.FullName -Algorithm SHA256).Hash.ToLowerInvariant() ) $($archive.Name)") { throw 'Reference ZIP checksum failed.' }Expand-Archive $archive.FullName artifacts/local/reference/extracted- - name: Build full native product- shell: pwsh- run: |- $PSNativeCommandUseErrorActionPreference = $true- dotnet restore artifacts/local/product-source/Aetheris.slnx -m:1 -nr:false- dotnet build artifacts/local/product-source/Aetheris.slnx -c Release --no-restore -m:1 -nr:false -p:UseSharedCompilation=false- - name: Run complete native regressions- shell: pwsh- run: |- $PSNativeCommandUseErrorActionPreference = $true- dotnet test artifacts/local/product-source/Aetheris.slnx -c Release --no-build -m:1 -- RunConfiguration.MaxCpuCount=1 xUnit.ParallelizeTestCollections=false- name: Package and extract native distributionshell: pwshrun: |@@ -103,6 +101,17 @@ jobs:npm ci --prefix test-support/CadmataDesktopSmoke --ignore-scriptsnode test-support/CadmataDesktopSmoke/node_modules/playwright-core/cli.js install --with-deps chromiumnode scripts/qualify-cadmata-browser.mts 'artifacts/local/extracted/Aetheris-${{ matrix.rid }}' artifacts/local/browser-smoke test-support/CadmataDesktopSmoke/node_modules/playwright-core/index.mjs artifacts/local/native-smoke/hole.step+ - name: Build full native qualification source+ shell: pwsh+ run: |+ $PSNativeCommandUseErrorActionPreference = $true+ dotnet restore Aetheris.slnx -m:1 -nr:false+ dotnet build Aetheris.slnx -c Release --no-restore -m:1 -nr:false -p:UseSharedCompilation=false+ - name: Run complete native regressions+ shell: pwsh+ run: |+ $PSNativeCommandUseErrorActionPreference = $true+ dotnet test Aetheris.slnx -c Release --no-build -m:1 -- RunConfiguration.MaxCpuCount=1 xUnit.ParallelizeTestCollections=false- uses: actions/upload-artifact@v4with:name: portable-bundle-${{ matrix.rid }}diff --git a/Aetheris.Kernel.Core.Tests/Step242/Step242NistAuditHarnessTests.cs b/Aetheris.Kernel.Core.Tests/Step242/Step242NistAuditHarnessTests.csindex 828b3694..de6e477e 100644--- a/Aetheris.Kernel.Core.Tests/Step242/Step242NistAuditHarnessTests.cs+++ b/Aetheris.Kernel.Core.Tests/Step242/Step242NistAuditHarnessTests.cs@@ -120,15 +120,18 @@ public sealed class Step242NistAuditHarnessTestsvar byPath = entries.ToDictionary(e => e.Path, StringComparer.Ordinal);// Native libm changes the last digits of recovered pcurves. Exact serialized// geometry sharing then changes entity numbering too. Preserve strict byte- // snapshots for the qualified Linux output without changing import evidence.- if (OperatingSystem.IsLinux())+ // snapshots for each qualified runtime without changing import evidence.+ var platform = OperatingSystem.IsLinux() ? "linux"+ : OperatingSystem.IsMacOS() && System.Runtime.InteropServices.RuntimeInformation.ProcessArchitecture == System.Runtime.InteropServices.Architecture.Arm64+ ? "osx-arm64" : null;+ if (platform is not null){- var linuxHashesPath = Path.Combine(Step242CorpusManifestRunner.RepoRoot(), "testdata", "step242", "manifests", "nist.v0.canonical-linux.json");- var linuxHashes = JsonSerializer.Deserialize<Dictionary<string, string>>(File.ReadAllText(linuxHashesPath, Encoding.UTF8));- Assert.NotNull(linuxHashes);- foreach (var (path, hash) in linuxHashes)+ var hashesPath = Path.Combine(Step242CorpusManifestRunner.RepoRoot(), "testdata", "step242", "manifests", $"nist.v0.canonical-{platform}.json");+ var hashes = JsonSerializer.Deserialize<Dictionary<string, string>>(File.ReadAllText(hashesPath, Encoding.UTF8));+ Assert.NotNull(hashes);+ foreach (var (path, hash) in hashes){- Assert.True(byPath.TryGetValue(path, out var baseline), $"Linux hash references missing snapshot entry '{path}'.");+ Assert.True(byPath.TryGetValue(path, out var baseline), $"{platform} hash references missing snapshot entry '{path}'.");Assert.NotNull(baseline);Assert.Equal("success", baseline.Status);Assert.Matches("^[0-9a-f]{64}$", hash);diff --git a/README.md b/README.mdindex 4e279404..c6d0d043 100644--- a/README.md+++ b/README.md@@ -43,7 +43,7 @@ Dangerous operations which may generate degenerate/sliver/zero-dimension geometr## Try it-The complete Windows experience is the `Aetheris-2.0.0-win-x64.zip` release bundle. It includes the CLI, Cadmata, NativeAOT Forge Host, public documentation, examples, and material catalog. The standalone managed .NET tool provides the CLI on Windows and Linux x64:+Download a self-contained [release bundle](https://github.com/yuechen-li-dev/Aetheris/releases/tag/v2.0.0) for Windows x64, Linux x64 or macOS Apple Silicon. Each includes the CLI, Cadmata browser viewer, Forge Host, documentation, examples and material catalog; no SDK or Node.js installation is needed. Follow the [bundle walkthrough](docs/public/release-bundle.md). For the CLI alone, install the managed .NET tool with the .NET 10 SDK:```powershelldotnet tool install --global Aetheris.CLI --version 2.0.0diff --git a/docs/development/reports/2026-10/NATIVE-BUNDLE-QUALIFICATION.md b/docs/development/reports/2026-10/NATIVE-BUNDLE-QUALIFICATION.mdnew file mode 100644index 00000000..4d06f6a0--- /dev/null+++ b/docs/development/reports/2026-10/NATIVE-BUNDLE-QUALIFICATION.md@@ -0,0 +1,46 @@+# Native bundle qualification++The Linux x64 and macOS arm64 distributions reuse the qualified 2.0.0 viewer+assets and build the tagged product source. Packaging provenance is recorded+separately. Existing Windows and NuGet binaries are preserved.++## Apple Silicon corpus classification++The first native full suite found two serialized NIST snapshot differences;+all other functional suites passed. Native interchange probe+[40207396231](https://github.com/yuechen-li-dev/Aetheris/actions/runs/40207396231)+exports FTC-09 and STC-09 using the unchanged tagged CLI. Disabling hardware+intrinsics produces the same Apple Silicon hashes, so disabling SIMD is not a+repair.++Independent Windows/macOS comparison found:++| Witness | Spatial vertices, edges and surface definitions | Largest recovered UV coordinate difference |+| --- | --- | ---: |+| FTC-09 | Exact identity-independent graph match | 1.5e-12 |+| STC-09 | Exact identity-independent graph match | 1.11e-11 |++The complete topology/association graph agrees at 1e-9 numeric resolution,+including strings and multiplicities. FTC-09 shares one additional immutable+point on macOS, changing subsequent serialized entity numbers. STC-09 differs+in one UV coordinate and matches the already qualified Linux hash.++The existing platform-specific snapshot owner now also reads two measured+Apple Silicon hashes. Every non-hash assertion remains unchanged. This is not+a production tolerance change, geometry rewrite, or permission to accept an+arbitrary new hash. Future changes must still match the strict platform baseline.+Raw STEP specimens and numeric comparison receipts are under ignored+`artifacts/local/release-2-final-check/native-corpus-*`.++## Build isolation and gates++Managed CLI/server publication is checked before the separate AOT Forge build,+preventing its intermediate compilation properties from contaminating shared+files. Shared-library byte mismatches remain errors.++Native package smoke checks run before the expensive full qualification suites.+The current qualification harness can differ from the tagged product only in+release tooling, documentation and test baselines; production source differences+reject. Packages still compile the unchanged tagged product, and full native+regressions gate artifact acceptance. Qualification evidence is attached to+[PR 820](https://github.com/yuechen-li-dev/Aetheris/pull/820).diff --git a/scripts/package-portable.ps1 b/scripts/package-portable.ps1index 3576a11f..d5cd6563 100644--- a/scripts/package-portable.ps1+++ b/scripts/package-portable.ps1@@ -29,9 +29,9 @@ $bundle = Join-Path $work $bundleNameNew-Item -ItemType Directory -Path $bundle, $output | Out-Null$publishArgs = @('-c', 'Release', '-r', $Runtime, '--self-contained', 'true', '-m:1', '-nr:false','-p:UseSharedCompilation=false', '-t:Rebuild', "-p:Version=$Version", '-p:DebugType=None', '-p:DebugSymbols=false')+dotnet clean (Join-Path $source 'Aetheris.slnx') -c Release -m:1 -nr:falsedotnet publish (Join-Path $source 'Aetheris.CLI/Aetheris.CLI.csproj') @publishArgs -o $bundle& (Join-Path $PSScriptRoot 'Test-CoreCliPayload.ps1') -AssetsPath (Join-Path $source 'Aetheris.CLI/obj/project.assets.json') -PublishDirectory $bundle-dotnet publish (Join-Path $source 'Aetheris.Forge.Host/Aetheris.Forge.Host.csproj') @publishArgs -p:PublishAot=true -o (Join-Path $bundle 'forge-host')$server = Join-Path $work 'server'dotnet publish (Join-Path $source 'Aetheris.Server/Aetheris.Server.csproj') @publishArgs -o $serverforeach ($file in Get-ChildItem -LiteralPath $server -Recurse -File) {@@ -47,6 +47,10 @@ foreach ($file in Get-ChildItem -LiteralPath $server -Recurse -File) {Copy-Item -LiteralPath $file.FullName -Destination $destination}}+# AOT uses different compilation properties and shares the SDK intermediate+# graph. Finish/check the two managed consumers before building the separate+# native host, so AOT-generated assemblies cannot leak into shared files.+dotnet publish (Join-Path $source 'Aetheris.Forge.Host/Aetheris.Forge.Host.csproj') @publishArgs -p:PublishAot=true -o (Join-Path $bundle 'forge-host')foreach ($directory in @('wwwroot', 'fixtures', 'testdata', 'samples')) {Copy-Item -LiteralPath (Join-Path $reference $directory) -Destination (Join-Path $bundle $directory) -Recurse}diff --git a/testdata/step242/manifests/nist.v0.canonical-osx-arm64.json b/testdata/step242/manifests/nist.v0.canonical-osx-arm64.jsonnew file mode 100644index 00000000..f24fd3cb--- /dev/null+++ b/testdata/step242/manifests/nist.v0.canonical-osx-arm64.json@@ -0,0 +1,4 @@+{+ "testdata/step242/nist/FTC/nist_ftc_09_asme1_ap242-e1.stp": "0caf8b0c71f538fd7f7fb5b57575b6564c07b791661e07af0bb9f012b3204dc2",+ "testdata/step242/nist/STC/nist_stc_09_asme1_ap242-e3.stp": "b1b0532b01efb53e726adc1ae371ce41e0114698dcb63d9885a62d8758498f38"+}