Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Prepare Aetheris 2.0.0-preview.1 release

Yuechen Lied56433d3882
diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
index a1b33666..26837460 100644
--- a/.github/workflows/dotnet.yml
+++ b/.github/workflows/dotnet.yml
@@ -2,7 +2,10 @@ name: dotnet
on:
push:
+ branches: [master]
+ tags: ["v*"]
pull_request:
+ workflow_dispatch:
jobs:
build-test:
@@ -31,3 +34,86 @@ jobs:
- name: Test kernel
run: dotnet test Aetheris.Kernel.Core.Tests/Aetheris.Kernel.Core.Tests.csproj --configuration Release --no-build
+
+ release-build:
+ if: startsWith(github.ref, 'refs/tags/v')
+ runs-on: windows-latest
+ permissions:
+ contents: read
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-dotnet@v4
+ with:
+ dotnet-version: 10.0.x
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 26
+ cache: npm
+ cache-dependency-path: aetheris.client/package-lock.json
+ - name: Restore and build frozen baseline
+ run: |
+ dotnet restore Aetheris.slnx
+ dotnet build Aetheris.slnx -f net10.0 --no-restore /m:1 -c Release
+ - name: Test frozen baseline
+ run: |
+ dotnet test Aetheris.Kernel.Core.Tests -f net10.0 -c Release --no-build
+ dotnet test Aetheris.Kernel.Firmament.Tests -f net10.0 -c Release --no-build
+ dotnet test Aetheris.CLI.Tests -f net10.0 -c Release --no-build
+ dotnet test Aetheris.Server.Tests -f net10.0 -c Release --no-build
+ - name: Package exact release bytes
+ shell: pwsh
+ run: ./scripts/package-release.ps1 -Version ($env:GITHUB_REF_NAME.TrimStart('v')) -OutputDirectory artifacts/release/published
+ - uses: actions/upload-artifact@v4
+ with:
+ name: preview1-release
+ path: artifacts/release/published
+ if-no-files-found: error
+
+ release-smoke:
+ needs: release-build
+ runs-on: windows-latest
+ steps:
+ - uses: actions/download-artifact@v4
+ with:
+ name: preview1-release
+ path: release
+ - name: Clean-directory CLI and package smoke
+ shell: pwsh
+ run: |
+ Expand-Archive release/Aetheris-${{ github.ref_name }}-win-x64.zip extracted
+ $cli = (Resolve-Path extracted/Aetheris-win-x64/aetheris.exe)
+ & $cli --version
+ & $cli --help
+ Copy-Item '${{ github.workspace }}/fixtures/FirmamentV2/Canonical/valid/box-through-hole.firmament' smoke.firmament
+ & $cli validate smoke.firmament
+ & $cli build smoke.firmament
+ & $cli inspect smoke.firmament
+ & $cli verify smoke.firmament
+ $package = Get-ChildItem release/packages/*.nupkg | Select-Object -First 1
+ Expand-Archive $package.FullName local-feed/Aetheris.CLI
+ if (-not (Test-Path local-feed/Aetheris.CLI/tools/net10.0/any/aetheris.dll)) { throw 'Tool payload missing.' }
+
+ publish:
+ needs: release-smoke
+ runs-on: ubuntu-latest
+ environment: production
+ permissions:
+ contents: write
+ id-token: write
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/download-artifact@v4
+ with:
+ name: preview1-release
+ path: release
+ - name: Authenticate to NuGet with trusted publishing
+ id: nuget-login
+ uses: NuGet/login@v1
+ - name: Publish the tested NuGet package
+ run: dotnet nuget push 'release/packages/*.nupkg' --source https://api.nuget.org/v3/index.json --api-key '${{ steps.nuget-login.outputs.NUGET_API_KEY }}' --skip-duplicate
+ - name: Create prerelease and upload the tested assets
+ env:
+ GH_TOKEN: ${{ github.token }}
+ run: |
+ gh release create "${GITHUB_REF_NAME}" --repo "${GITHUB_REPOSITORY}" --title "Aetheris ${GITHUB_REF_NAME#v}" --prerelease --notes-file docs/release/2.0.0-preview.1-notes.md release/Aetheris-*.zip release/aetheris-firmament-*.vsix release/SHA256SUMS.txt release/packages/*.nupkg || \
+ gh release upload "${GITHUB_REF_NAME}" --repo "${GITHUB_REPOSITORY}" --clobber release/Aetheris-*.zip release/aetheris-firmament-*.vsix release/SHA256SUMS.txt release/packages/*.nupkg
diff --git a/.gitignore b/.gitignore
index b50bb19d..a7fbbcbb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -73,6 +73,9 @@ artifacts/release/*
!artifacts/release/interop/
!artifacts/release/interop/**
!docs/release/
+!docs/release/Aetheris.CLI.README.md
+!docs/release/2.0.0-preview.1-notes.md
+!docs/release/2.0.0-preview.1-release.md
!docs/release/preview1-baseline-stabilization-x1.md
# ASP.NET Scaffolding
diff --git a/Aetheris.CLI/Aetheris.CLI.csproj b/Aetheris.CLI/Aetheris.CLI.csproj
index 90dda6e0..4ea87e93 100644
--- a/Aetheris.CLI/Aetheris.CLI.csproj
+++ b/Aetheris.CLI/Aetheris.CLI.csproj
@@ -5,6 +5,19 @@
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<AssemblyName>aetheris</AssemblyName>
+ <PackAsTool>true</PackAsTool>
+ <ToolCommandName>aetheris</ToolCommandName>
+ <PackageId>Aetheris.CLI</PackageId>
+ <Authors>Yuechen Li</Authors>
+ <Description>The Aetheris command-line compiler for bounded exact Firmament CAD and STEP AP242 workflows.</Description>
+ <PackageTags>cad;firmament;step;ap242;geometry</PackageTags>
+ <RepositoryUrl>https://github.com/yuechen-li-dev/Aetheris</RepositoryUrl>
+ <RepositoryType>git</RepositoryType>
+ <ProjectUrl>https://yuechen-li-dev.github.io/aetheris/</ProjectUrl>
+ <PackageLicenseExpression>AGPL-3.0-only</PackageLicenseExpression>
+ <PackageReadmeFile>Aetheris.CLI.README.md</PackageReadmeFile>
+ <PackageReleaseNotes>Preview 1: first public Aetheris CLI release.</PackageReleaseNotes>
+ <AllowedOutputExtensionsInPackageBuildOutputFolder>.dll;.exe;.json</AllowedOutputExtensionsInPackageBuildOutputFolder>
</PropertyGroup>
<ItemGroup>
@@ -12,4 +25,8 @@
<ProjectReference Include="..\Aetheris.Kernel.Core\Aetheris.Kernel.Core.csproj" />
<ProjectReference Include="..\Aetheris.Firmament.FrictionLab\Aetheris.Firmament.FrictionLab.csproj" />
</ItemGroup>
+
+ <ItemGroup>
+ <None Include="..\docs\release\Aetheris.CLI.README.md" Pack="true" PackagePath="\" Link="Aetheris.CLI.README.md" />
+ </ItemGroup>
</Project>
diff --git a/Aetheris.CLI/CliRunner.cs b/Aetheris.CLI/CliRunner.cs
index 837d08dd..4497e89b 100644
--- a/Aetheris.CLI/CliRunner.cs
+++ b/Aetheris.CLI/CliRunner.cs
@@ -2965,8 +2965,13 @@ public static class CliRunner
private static string GetDisplayVersion()
{
- var version = typeof(CliRunner).Assembly.GetName().Version;
- return version is null ? "unknown" : version.ToString();
+ var assembly = typeof(CliRunner).Assembly;
+ var informational = assembly.GetCustomAttributes(typeof(System.Reflection.AssemblyInformationalVersionAttribute), inherit: false)
+ .OfType<System.Reflection.AssemblyInformationalVersionAttribute>()
+ .SingleOrDefault()?.InformationalVersion;
+ return string.IsNullOrWhiteSpace(informational)
+ ? assembly.GetName().Version?.ToString() ?? "unknown"
+ : informational.Split('+', 2)[0];
}
private static void WriteTopLevelHelp(TextWriter stdout)
diff --git a/Directory.Build.props b/Directory.Build.props
index 61de972e..239dfb96 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -1,5 +1,9 @@
<Project>
<PropertyGroup>
+ <Version>2.0.0-preview.1</Version>
+ <AssemblyVersion>2.0.0.0</AssemblyVersion>
+ <FileVersion>2.0.0.0</FileVersion>
+ <InformationalVersion>2.0.0-preview.1</InformationalVersion>
<TreatWarningsAsErrors>false</TreatWarningsAsErrors>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
diff --git a/docs/release/2.0.0-preview.1-notes.md b/docs/release/2.0.0-preview.1-notes.md
new file mode 100644
index 00000000..31995e2a
--- /dev/null
+++ b/docs/release/2.0.0-preview.1-notes.md
@@ -0,0 +1,24 @@
+# Aetheris 2.0.0-preview.1
+
+First public preview of Aetheris, the exact code-first CAD compiler.
+
+## Highlights
+
+- Firmament V2 and deterministic STEP AP242 output.
+- Primitives, profiles, Compose, bounded mechanical features, PMI, verification, and bounded existing-STEP workflows.
+- Cadmata viewer in the Windows bundle and the Aetheris Firmament VS Code extension.
+
+## Install
+
+Download and extract the Windows bundle for the complete CLI and Cadmata viewer,
+or run `dotnet tool install --global Aetheris.CLI --prerelease` for the CLI.
+
+## Important Preview limitations
+
+- Mixed whole-loop Fillet remains Experimental.
+- Concept Path-derived Profiles are not accepted by Compose.
+- Foreign STEP recognition/replacement is deliberately bounded.
+- The known Parasolid chamfer interoperability limitation remains.
+- Tessellated B-rep volume is non-authoritative; CIR/FRep expansion is deferred.
+
+Documentation: https://yuechen-li-dev.github.io/aetheris/
diff --git a/docs/release/Aetheris.CLI.README.md b/docs/release/Aetheris.CLI.README.md
new file mode 100644
index 00000000..d486de2c
--- /dev/null
+++ b/docs/release/Aetheris.CLI.README.md
@@ -0,0 +1,19 @@
+# Aetheris CLI
+
+`Aetheris.CLI` installs the `aetheris` command-line compiler for the bounded
+Firmament exact-CAD and STEP AP242 workflow.
+
+```powershell
+dotnet tool install --global Aetheris.CLI --prerelease
+aetheris --help
+```
+
+The tool supports validation, STEP build, inspection, analysis, and verification
+from Firmament source. It requires the .NET 10 runtime.
+
+`aetheris view` needs Cadmata. The NuGet global tool does not bundle the viewer;
+download the Windows bundle from the GitHub release for package-relative Cadmata
+discovery and the complete desktop experience.
+
+See the [Aetheris manual](https://yuechen-li-dev.github.io/aetheris/) for the
+supported Firmament surface and Preview 1 limitations.
diff --git a/docs/roadmap/preview2-start.md b/docs/roadmap/preview2-start.md
new file mode 100644
index 00000000..82087150
--- /dev/null
+++ b/docs/roadmap/preview2-start.md
@@ -0,0 +1,13 @@
+# Preview 2 starting backlog
+
+Preview 1 establishes the public package and Windows-bundle baseline. Preview 2
+starts from its frozen support matrix; it does not retroactively expand Preview
+1 claims.
+
+- CIR/FRep authoritative occupied-volume evidence and whole-loop Fillet CIR lowering.
+- Re-evaluate promotion of experimental mixed whole-loop Fillet after that evidence.
+- Admit Concept Path-derived Profiles to Compose.
+- Carry canonical-parser diagnostic source spans end to end.
+- Refactor Cadmata around MachinaLayout.js and consolidate its TSPack path.
+- Broaden foreign STEP boundary and negative-coverage testing without claiming general recovery.
+- Investigate the known Parasolid chamfer interoperability behavior.
diff --git a/scripts/package-release.ps1 b/scripts/package-release.ps1
new file mode 100644
index 00000000..8bba2974
--- /dev/null
+++ b/scripts/package-release.ps1
@@ -0,0 +1,36 @@
+[CmdletBinding()]
+param(
+ [Parameter(Mandatory = $true)]
+ [string]$Version,
+ [Parameter(Mandatory = $true)]
+ [string]$OutputDirectory
+)
+
+$ErrorActionPreference = 'Stop'
+$repoRoot = Split-Path -Parent $PSScriptRoot
+$output = [System.IO.Path]::GetFullPath((Join-Path $repoRoot $OutputDirectory))
+$stage = Join-Path $output 'stage'
+Remove-Item -LiteralPath $output -Recurse -Force -ErrorAction SilentlyContinue
+New-Item -ItemType Directory -Force -Path $stage, (Join-Path $output 'packages') | Out-Null
+
+Push-Location (Join-Path $repoRoot 'aetheris.client')
+try {
+ npm ci
+ npm test
+ npm run build
+}
+finally { Pop-Location }
+
+dotnet publish (Join-Path $repoRoot 'Aetheris.CLI/Aetheris.CLI.csproj') -c Release -r win-x64 --self-contained true -p:Version=$Version -o (Join-Path $stage 'Aetheris-win-x64')
+dotnet publish (Join-Path $repoRoot 'Aetheris.Server/Aetheris.Server.csproj') -c Release -r win-x64 --self-contained true -p:Version=$Version -o (Join-Path $stage 'Aetheris-win-x64/cadmata')
+dotnet pack (Join-Path $repoRoot 'Aetheris.CLI/Aetheris.CLI.csproj') -c Release --no-build -p:Version=$Version -o (Join-Path $output 'packages')
+Get-ChildItem -LiteralPath $stage -Recurse -Filter '*.pdb' -File | Remove-Item -Force
+
+$vsix = Join-Path $repoRoot 'artifacts/vscode/aetheris-firmament-0.1.0-preview.1.vsix'
+if (-not (Test-Path -LiteralPath $vsix)) { throw "Validated VSIX not found: $vsix" }
+Copy-Item -LiteralPath $vsix -Destination $output
+
+$zip = Join-Path $output "Aetheris-$Version-win-x64.zip"
+Compress-Archive -Path (Join-Path $stage 'Aetheris-win-x64') -DestinationPath $zip -CompressionLevel Optimal
+$releaseFiles = @($zip, (Join-Path $output 'aetheris-firmament-0.1.0-preview.1.vsix')) + (Get-ChildItem -LiteralPath (Join-Path $output 'packages') -Filter '*.nupkg' -File | Select-Object -ExpandProperty FullName)
+$releaseFiles | Get-FileHash -Algorithm SHA256 | ForEach-Object { "{0} {1}" -f $_.Hash.ToLowerInvariant(), $_.Path.Substring($output.Length + 1) } | Set-Content (Join-Path $output 'SHA256SUMS.txt')