Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Publish Preview 2 public library packages

Yuechen Lif91f561dfc23
diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.yml
index fe21edd9..7a04a01c 100644
--- a/.github/workflows/dotnet.yml
+++ b/.github/workflows/dotnet.yml
@@ -35,6 +35,72 @@ jobs:
- name: Test kernel
run: dotnet test Aetheris.Kernel.Core.Tests/Aetheris.Kernel.Core.Tests.csproj --configuration Release --no-build --filter "Category!=SlowCorpus"
+ public-library-build:
+ if: github.event_name == 'workflow_dispatch'
+ runs-on: windows-latest
+ permissions:
+ contents: read
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-dotnet@v4
+ with:
+ dotnet-version: 10.0.x
+ - name: Pack public library dependency graph
+ shell: pwsh
+ run: ./scripts/package-public-libraries.ps1 -OutputDirectory artifacts/packages/public-libraries
+ - uses: actions/upload-artifact@v4
+ with:
+ name: public-libraries-preview2
+ path: artifacts/packages/public-libraries
+ if-no-files-found: error
+
+ public-library-smoke:
+ needs: public-library-build
+ runs-on: windows-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-dotnet@v4
+ with:
+ dotnet-version: 10.0.x
+ - uses: actions/download-artifact@v4
+ with:
+ name: public-libraries-preview2
+ path: local-feed
+ - name: Restore and run clean public-package consumer
+ shell: pwsh
+ run: |
+ $smoke = Join-Path $env:RUNNER_TEMP 'aetheris-public-package-smoke'
+ Copy-Item tests/PublicPackageSmoke $smoke -Recurse
+ dotnet restore "$smoke/PublicPackageSmoke.csproj" --source "$pwd/local-feed" --no-cache
+ dotnet run --project "$smoke/PublicPackageSmoke.csproj" --configuration Release --no-restore
+
+ publish-public-libraries:
+ if: github.event_name == 'workflow_dispatch' && github.ref == 'refs/heads/master'
+ needs: [build-test, public-library-smoke]
+ runs-on: ubuntu-latest
+ environment: production
+ permissions:
+ contents: read
+ id-token: write
+ steps:
+ - uses: actions/download-artifact@v4
+ with:
+ name: public-libraries-preview2
+ path: packages
+ - name: Authenticate to NuGet with trusted publishing
+ id: nuget-login
+ uses: NuGet/login@v1
+ with:
+ user: yuechen-li
+ - name: Publish tested packages in dependency order
+ shell: pwsh
+ run: |
+ Get-Content packages/PACKAGE_ORDER.txt | ForEach-Object {
+ $package = "packages/$_.2.0.0-preview.2.nupkg"
+ dotnet nuget push $package --source https://api.nuget.org/v3/index.json --api-key '${{ steps.nuget-login.outputs.NUGET_API_KEY }}' --skip-duplicate
+ if ($LASTEXITCODE -ne 0) { throw "NuGet push failed for $_" }
+ }
+
release-build:
if: startsWith(github.ref, 'refs/tags/v')
runs-on: windows-latest
diff --git a/Aetheris.Forge.Host/Aetheris.Forge.Host.csproj b/Aetheris.Forge.Host/Aetheris.Forge.Host.csproj
index 86f5b811..0a1c31d8 100644
--- a/Aetheris.Forge.Host/Aetheris.Forge.Host.csproj
+++ b/Aetheris.Forge.Host/Aetheris.Forge.Host.csproj
@@ -3,6 +3,7 @@
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
+ <Description>Stable application-host integration APIs for compiling and invoking typed Aetheris Forge programs.</Description>
</PropertyGroup>
<ItemGroup>
<ProjectReference Include="..\Aetheris.Forge\Aetheris.Forge.csproj" />
diff --git a/Aetheris.Forge/Aetheris.Forge.csproj b/Aetheris.Forge/Aetheris.Forge.csproj
index ee2ec0b7..ad5c90cb 100644
--- a/Aetheris.Forge/Aetheris.Forge.csproj
+++ b/Aetheris.Forge/Aetheris.Forge.csproj
@@ -3,6 +3,7 @@
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
+ <Description>Typed Forge contracts and values shared by Aetheris Host and KernelSDK integrations.</Description>
</PropertyGroup>
<ItemGroup>
diff --git a/Aetheris.Kernel.Core/Aetheris.Kernel.Core.csproj b/Aetheris.Kernel.Core/Aetheris.Kernel.Core.csproj
index 6c3a8871..b226e49a 100644
--- a/Aetheris.Kernel.Core/Aetheris.Kernel.Core.csproj
+++ b/Aetheris.Kernel.Core/Aetheris.Kernel.Core.csproj
@@ -3,5 +3,6 @@
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
+ <Description>Core exact-geometry, ConstructionIR, BRep, STEP AP242, and inspection APIs for Aetheris.</Description>
</PropertyGroup>
</Project>
diff --git a/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj b/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj
index 0b1ccc89..aaba8dc1 100644
--- a/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj
+++ b/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj
@@ -3,6 +3,7 @@
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
+ <Description>The Firmament V2 parser, compiler, semantic pipeline, assembly, drawing, and review runtime for Aetheris.</Description>
</PropertyGroup>
<ItemGroup>
diff --git a/Directory.Build.props b/Directory.Build.props
index bdae2045..c178db35 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -7,5 +7,23 @@
<TreatWarningsAsErrors>false</TreatWarningsAsErrors>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
+ <Authors Condition="'$(Authors)' == ''">Yuechen Li</Authors>
+ <Company Condition="'$(Company)' == ''">Aetheris</Company>
+ <Description Condition="'$(Description)' == ''">Aetheris engineering CAD runtime component.</Description>
+ <PackageLicenseExpression Condition="'$(PackageLicenseExpression)' == ''">AGPL-3.0-only</PackageLicenseExpression>
+ <PackageProjectUrl Condition="'$(PackageProjectUrl)' == ''">https://yuechen-li-dev.github.io/aetheris/</PackageProjectUrl>
+ <RepositoryUrl Condition="'$(RepositoryUrl)' == ''">https://github.com/yuechen-li-dev/Aetheris</RepositoryUrl>
+ <RepositoryType Condition="'$(RepositoryType)' == ''">git</RepositoryType>
+ <PackageTags Condition="'$(PackageTags)' == ''">cad;firmament;step;ap242;geometry;engineering</PackageTags>
+ <PackageReleaseNotes Condition="'$(PackageReleaseNotes)' == ''">Aetheris 2.0.0-preview.2 public library package.</PackageReleaseNotes>
+ <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
+ <PublishRepositoryUrl>true</PublishRepositoryUrl>
+ <PackageReadmeFile Condition="'$(PackageReadmeFile)' == '' and '$(MSBuildProjectName)' != 'Aetheris.CLI'">Aetheris.Libraries.README.md</PackageReadmeFile>
</PropertyGroup>
+ <ItemGroup Condition="'$(MSBuildProjectName)' != 'Aetheris.CLI'">
+ <None Include="$(MSBuildThisFileDirectory)docs\release\Aetheris.Libraries.README.md"
+ Pack="true"
+ PackagePath="\"
+ Link="Aetheris.Libraries.README.md" />
+ </ItemGroup>
</Project>
diff --git a/docs/release/Aetheris.Libraries.README.md b/docs/release/Aetheris.Libraries.README.md
new file mode 100644
index 00000000..4b58e633
--- /dev/null
+++ b/docs/release/Aetheris.Libraries.README.md
@@ -0,0 +1,19 @@
+# Aetheris public libraries
+
+Aetheris is a code-first engineering CAD stack for exact STEP AP242 workflows,
+Firmament V2 compilation, typed Forge integration, assemblies, drawings,
+analysis, and engineering modules.
+
+The primary integration packages are:
+
+- `Aetheris.Kernel.Core` for exact geometry and STEP APIs;
+- `Aetheris.Kernel.Firmament` for the Firmament compiler/runtime;
+- `Aetheris.Forge.Host` for ordinary application integration; and
+- `Aetheris.Forge.KernelSDK` for advanced extension development.
+
+KernelSDK extensions are Safe by default at the Aetheris capability boundary.
+Extensions declaring `UNSAFE` require explicit host consent. Because extensions
+execute in-process, this API policy is not a cryptographic CLR sandbox.
+
+Preview 2 targets .NET 10. Documentation and examples are available at
+<https://yuechen-li-dev.github.io/aetheris/>.
diff --git a/scripts/package-public-libraries.ps1 b/scripts/package-public-libraries.ps1
new file mode 100644
index 00000000..d7e546ae
--- /dev/null
+++ b/scripts/package-public-libraries.ps1
@@ -0,0 +1,58 @@
+param(
+ [string]$Version = "2.0.0-preview.2",
+ [string]$OutputDirectory = "artifacts/packages/public-libraries"
+)
+
+$ErrorActionPreference = "Stop"
+$repoRoot = Split-Path -Parent $PSScriptRoot
+$outputPath = [IO.Path]::GetFullPath((Join-Path $repoRoot $OutputDirectory))
+
+if (Test-Path -LiteralPath $outputPath) {
+ $existing = @(Get-ChildItem -LiteralPath $outputPath -Force)
+ if ($existing.Count -gt 0) {
+ throw "Package output directory must be empty: $outputPath"
+ }
+} else {
+ New-Item -ItemType Directory -Path $outputPath | Out-Null
+}
+
+# Topological order is also the intended NuGet publication order.
+$projects = @(
+ "Aetheris.Kernel.Core/Aetheris.Kernel.Core.csproj",
+ "Aetheris.Modules/Aetheris.Modules.csproj",
+ "Aetheris.Semantics/Aetheris.Semantics.csproj",
+ "Aetheris.Forge/Aetheris.Forge.csproj",
+ "Aetheris.Collaboration/Aetheris.Collaboration.csproj",
+ "Aetheris.Kernel.StandardLibrary/Aetheris.Kernel.StandardLibrary.csproj",
+ "Aetheris.Continuum/Aetheris.Continuum.csproj",
+ "Aetheris.Surfacing/Aetheris.Surfacing.csproj",
+ "Aetheris.Piping/Aetheris.Piping.csproj",
+ "Aetheris.SheetMetal/Aetheris.SheetMetal.csproj",
+ "Aetheris.Modules.BuiltIn/Aetheris.Modules.BuiltIn.csproj",
+ "Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj",
+ "Aetheris.FEA/Aetheris.FEA.csproj",
+ "Aetheris.Forge.Host/Aetheris.Forge.Host.csproj",
+ "Aetheris.Forge.KernelSDK/Aetheris.Forge.KernelSDK.csproj"
+)
+
+Push-Location $repoRoot
+try {
+ foreach ($project in $projects) {
+ dotnet pack $project --configuration Release --output $outputPath -p:PackageVersion=$Version
+ if ($LASTEXITCODE -ne 0) {
+ throw "dotnet pack failed for $project"
+ }
+ }
+
+ $packageIds = $projects | ForEach-Object { [IO.Path]::GetFileNameWithoutExtension($_) }
+ $packageIds | Set-Content -LiteralPath (Join-Path $outputPath "PACKAGE_ORDER.txt") -Encoding utf8NoBOM
+
+ $packages = @(Get-ChildItem -LiteralPath $outputPath -Filter "*.nupkg" -File)
+ if ($packages.Count -ne $projects.Count) {
+ throw "Expected $($projects.Count) packages but found $($packages.Count)."
+ }
+} finally {
+ Pop-Location
+}
+
+Write-Output "Packed $($projects.Count) public Aetheris libraries to $outputPath"
diff --git a/tests/PublicPackageSmoke/Program.cs b/tests/PublicPackageSmoke/Program.cs
new file mode 100644
index 00000000..69d6b16e
--- /dev/null
+++ b/tests/PublicPackageSmoke/Program.cs
@@ -0,0 +1,24 @@
+using System.Reflection;
+
+string[] packageAssemblies =
+[
+ "Aetheris.Kernel.Core",
+ "Aetheris.Kernel.Firmament",
+ "Aetheris.Forge.Host",
+ "Aetheris.Forge.KernelSDK"
+];
+
+foreach (var assemblyName in packageAssemblies)
+{
+ var assembly = Assembly.Load(assemblyName);
+ var version = assembly
+ .GetCustomAttribute<AssemblyInformationalVersionAttribute>()?
+ .InformationalVersion;
+
+ if (version is null || !version.StartsWith("2.0.0-preview.2", StringComparison.Ordinal))
+ {
+ throw new InvalidOperationException($"{assemblyName} reported unexpected version '{version}'.");
+ }
+
+ Console.WriteLine($"{assemblyName} {version}");
+}
diff --git a/tests/PublicPackageSmoke/PublicPackageSmoke.csproj b/tests/PublicPackageSmoke/PublicPackageSmoke.csproj
new file mode 100644
index 00000000..651c9062
--- /dev/null
+++ b/tests/PublicPackageSmoke/PublicPackageSmoke.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+ <PropertyGroup>
+ <OutputType>Exe</OutputType>
+ <TargetFramework>net10.0</TargetFramework>
+ <ImplicitUsings>enable</ImplicitUsings>
+ <Nullable>enable</Nullable>
+ </PropertyGroup>
+ <ItemGroup>
+ <PackageReference Include="Aetheris.Kernel.Core" Version="2.0.0-preview.2" />
+ <PackageReference Include="Aetheris.Kernel.Firmament" Version="2.0.0-preview.2" />
+ <PackageReference Include="Aetheris.Forge.Host" Version="2.0.0-preview.2" />
+ <PackageReference Include="Aetheris.Forge.KernelSDK" Version="2.0.0-preview.2" />
+ </ItemGroup>
+</Project>