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.ymlindex a1b33666..26837460 100644--- a/.github/workflows/dotnet.yml+++ b/.github/workflows/dotnet.yml@@ -2,7 +2,10 @@ name: dotneton:push:+ branches: [master]+ tags: ["v*"]pull_request:+ workflow_dispatch:jobs:build-test:@@ -31,3 +34,86 @@ jobs:- name: Test kernelrun: 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/*.nupkgdiff --git a/.gitignore b/.gitignoreindex 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 Scaffoldingdiff --git a/Aetheris.CLI/Aetheris.CLI.csproj b/Aetheris.CLI/Aetheris.CLI.csprojindex 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.csindex 837d08dd..4497e89b 100644--- a/Aetheris.CLI/CliRunner.cs+++ b/Aetheris.CLI/CliRunner.cs@@ -2965,8 +2965,13 @@ public static class CliRunnerprivate 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.propsindex 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.ps1new file mode 100644index 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')