Skip to content

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.yml
index 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 distribution
shell: pwsh
run: |
@@ -103,6 +101,17 @@ jobs:
npm ci --prefix test-support/CadmataDesktopSmoke --ignore-scripts
node test-support/CadmataDesktopSmoke/node_modules/playwright-core/cli.js install --with-deps chromium
node 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@v4
with:
name: portable-bundle-${{ matrix.rid }}
diff --git a/Aetheris.Kernel.Core.Tests/Step242/Step242NistAuditHarnessTests.cs b/Aetheris.Kernel.Core.Tests/Step242/Step242NistAuditHarnessTests.cs
index 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 Step242NistAuditHarnessTests
var 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.md
index 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:
```powershell
dotnet tool install --global Aetheris.CLI --version 2.0.0
diff --git a/docs/development/reports/2026-10/NATIVE-BUNDLE-QUALIFICATION.md b/docs/development/reports/2026-10/NATIVE-BUNDLE-QUALIFICATION.md
new file mode 100644
index 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.ps1
index 3576a11f..d5cd6563 100644
--- a/scripts/package-portable.ps1
+++ b/scripts/package-portable.ps1
@@ -29,9 +29,9 @@ $bundle = Join-Path $work $bundleName
New-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:false
dotnet 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 $server
foreach ($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.json
new file mode 100644
index 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"
+}