Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Pin released managed WGSL packages and prepare a gated 2.0.0 release lane
Yuechen Li27bbf8d02992
diff --git a/.github/actions/prepare-managed-wgsl/action.yml b/.github/actions/prepare-managed-wgsl/action.ymlindex e60c8090..2b28c1a8 100644--- a/.github/actions/prepare-managed-wgsl/action.yml+++ b/.github/actions/prepare-managed-wgsl/action.yml@@ -1,22 +1,11 @@-name: Prepare managed WGSL dependency-description: Build the reviewed Copeland source graph into Aetheris's ignored local NuGet feed.+name: Restore released managed WGSL dependency+description: Restore the public compiler package; no Copeland checkout or private feed is required.runs:using: compositesteps:- - name: Read reviewed compiler commit- id: pin+ - name: Restore public managed compilershell: pwshrun: |- $commit = (Get-Content scripts/managed-wgsl-commit-pin.txt -Raw).Trim()- if ($commit -notmatch '^[0-9a-f]{40}$') { throw 'Invalid managed WGSL commit pin.' }- "commit=$commit" | Out-File $env:GITHUB_OUTPUT -Encoding utf8 -Append- - name: Checkout reviewed compiler- uses: actions/checkout@v4- with:- repository: yuechen-li-dev/Copeland- ref: ${{ steps.pin.outputs.commit }}- path: artifacts/local/managed-wgsl/source- persist-credentials: false- - name: Pack source-pinned managed compiler- shell: pwsh- run: ./scripts/prepare-managed-wgsl.ps1 -CopelandRoot artifacts/local/managed-wgsl/source+ $env:MSBUILDDISABLENODEREUSE = '1'+ dotnet restore Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj -m:1 -nr:false --source https://api.nuget.org/v3/index.json+ if ($LASTEXITCODE -ne 0) { throw 'Public compiler dependency restore failed.' }diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.ymlindex eb43bfac..496ed537 100644--- a/.github/workflows/dotnet.yml+++ b/.github/workflows/dotnet.yml@@ -6,6 +6,14 @@ on:tags: ["v*"]pull_request:workflow_dispatch:+ inputs:+ publish:+ description: Publish the qualified release candidate+ type: boolean+ default: false++env:+ MSBUILDDISABLENODEREUSE: '1'jobs:build-test:@@ -70,82 +78,10 @@ jobs:if ($packages.Count -ne 1) { throw 'Expected one core CLI package' }./scripts/Test-CoreCliPayload.ps1 -PackagePath $packages[0].FullName- 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: Prepare managed WGSL dependency- uses: ./.github/actions/prepare-managed-wgsl- - 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-preview3- 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-preview3- path: local-feed- - name: Restore and run clean public-package consumer- shell: pwsh- run: |- $smoke = Join-Path $env:RUNNER_TEMP 'aetheris-public-package-smoke'- $packages = Join-Path $env:RUNNER_TEMP 'aetheris-public-package-cache'- $nugetConfigDirectory = Join-Path $env:RUNNER_TEMP 'aetheris-public-package-nuget'- Copy-Item test-support/PublicPackageSmoke $smoke -Recurse- dotnet new nugetconfig --output $nugetConfigDirectory --force- dotnet nuget add source "$pwd/local-feed" --name aetheris-local --configfile "$nugetConfigDirectory/NuGet.Config"- dotnet restore "$smoke/PublicPackageSmoke.csproj" --configfile "$nugetConfigDirectory/NuGet.Config" --packages $packages --no-cache- dotnet run --project "$smoke/PublicPackageSmoke.csproj" --configuration Release --no-restore --property:RestorePackagesPath=$packages-- 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-preview3- 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.3.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:- # This frozen lane hardcodes Preview 3 package names and release notes.- # Preview 4 publishes its separately qualified portable Cadmata artifact.- if: github.ref == 'refs/tags/v2.0.0-preview.3'+ outputs:+ version: ${{ steps.version.outputs.version }}+ if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'needs: build-testruns-on: windows-latestpermissions:@@ -157,7 +93,7 @@ jobs:dotnet-version: 10.0.x- uses: actions/setup-node@v4with:- node-version: 26+ node-version: 24- uses: actions/checkout@v4with:repository: yuechen-li-dev/tspack@@ -198,37 +134,49 @@ jobs:& "$toolDirectory/tspack.exe" --version- name: Prepare managed WGSL dependencyuses: ./.github/actions/prepare-managed-wgsl- - name: Restore and build Preview 3 frozen baseline+ - name: Restore and build the release candidaterun: |dotnet restore Aetheris.slnxdotnet build Aetheris.slnx --no-restore /m:1 -c Release- - name: Test frozen baseline+ - name: Test the release candidaterun: dotnet test Aetheris.slnx -c Release --no-build -m:1 -- RunConfiguration.MaxCpuCount=1- name: Package exact release bytes+ id: versionshell: pwshrun: |- $version = $env:GITHUB_REF_NAME.TrimStart('v')+ [xml]$props = Get-Content Directory.Build.props -Raw+ $version = [string]$props.Project.PropertyGroup.Version+ "version=$version" >> $env:GITHUB_OUTPUT+ if ($env:GITHUB_REF -like 'refs/tags/*' -and $env:GITHUB_REF_NAME -ne "v$version") { throw 'Release tag and source version disagree.' }./scripts/package-release.ps1 -Version $version -OutputDirectory artifacts/release/published./scripts/package-public-libraries.ps1 -Version $version -OutputDirectory artifacts/release/public-libraries./scripts/finalize-publication.ps1 -ReleaseDirectory artifacts/release/published -PublicLibrariesDirectory artifacts/release/public-libraries- uses: actions/upload-artifact@v4with:- name: preview3-release+ name: aetheris-releasepath: artifacts/release/publishedif-no-files-found: errorrelease-smoke:needs: release-build- runs-on: windows-latest+ strategy:+ matrix:+ os: [windows-latest, ubuntu-latest]+ runs-on: ${{ matrix.os }}steps:- uses: actions/checkout@v4- uses: actions/download-artifact@v4with:- name: preview3-release+ name: aetheris-releasepath: release- - name: Clean-directory CLI and package smoke+ - uses: actions/setup-dotnet@v4+ with:+ dotnet-version: 10.0.x+ - name: Clean-directory Windows bundle smoke+ if: runner.os == 'Windows'shell: pwshrun: |+ $PSNativeCommandUseErrorActionPreference = $true$zip = Get-ChildItem release/Aetheris-*-win-x64.zip | Select-Object -First 1Expand-Archive $zip.FullName extracted$cli = (Resolve-Path extracted/Aetheris-win-x64/aetheris.exe)@@ -244,32 +192,37 @@ jobs:Copy-Item '${{ github.workspace }}/fixtures/Canonical/Drawings/bearing-block-production-drawing.firmament' drawing.firmament& $cli drawing compile drawing.firmament --out-dir drawing-out --jsonif (-not (Test-Path drawing-out/*.pdf) -or -not (Test-Path drawing-out/*.pptx)) { throw 'Drawing PDF/PPTX smoke outputs missing.' }+ - name: Install and exercise the portable tool+ shell: pwsh+ run: |+ $PSNativeCommandUseErrorActionPreference = $true+ Copy-Item fixtures/Canonical/Features/Holes/through-hole.firmament tool-smoke.firmament$package = Get-ChildItem release/packages/*.nupkg | Select-Object -First 1New-Item -ItemType Directory local-feed, installed-tool | Out-NullCopy-Item $package.FullName local-feed- dotnet tool install --tool-path installed-tool Aetheris.CLI --version 2.0.0-preview.3 --add-source local-feed --ignore-failed-sources+ dotnet tool install --tool-path installed-tool Aetheris.CLI --version ${{ needs.release-build.outputs.version }} --add-source local-feed --ignore-failed-sources& installed-tool/aetheris --version- & installed-tool/aetheris build smoke.firmament+ & installed-tool/aetheris validate tool-smoke.firmament --json+ & installed-tool/aetheris build tool-smoke.firmament --out tool-smoke.step --json+ & installed-tool/aetheris verify tool-smoke.firmament --json- name: Verify checksums and public packagesshell: pwsh+ env:+ AETHERIS_RELEASE_VERSION: ${{ needs.release-build.outputs.version }}run: |+ $PSNativeCommandUseErrorActionPreference = $trueforeach ($line in Get-Content release/SHA256SUMS.txt) {if ($line -notmatch '^([0-9a-f]{64}) (.+)$') { throw "Malformed checksum line: $line" }$path = Join-Path (Resolve-Path release) $Matches[2]$actual = (Get-FileHash $path -Algorithm SHA256).Hash.ToLowerInvariant()if ($actual -ne $Matches[1]) { throw "Checksum mismatch: $($Matches[2])" }}- $smoke = Join-Path $env:RUNNER_TEMP 'aetheris-preview3-public-package-smoke'- $packages = Join-Path $env:RUNNER_TEMP 'aetheris-preview3-public-package-cache'- $nugetConfigDirectory = Join-Path $env:RUNNER_TEMP 'aetheris-preview3-public-package-nuget'- Copy-Item test-support/PublicPackageSmoke $smoke -Recurse- dotnet new nugetconfig --output $nugetConfigDirectory --force- dotnet nuget add source "$pwd/release/packages/public-libraries" --name aetheris-local --configfile "$nugetConfigDirectory/NuGet.Config"- dotnet restore "$smoke/PublicPackageSmoke.csproj" --configfile "$nugetConfigDirectory/NuGet.Config" --packages $packages --no-cache- dotnet run --project "$smoke/PublicPackageSmoke.csproj" --configuration Release --no-restore --property:RestorePackagesPath=$packages+ ./scripts/Test-PublicPackageGraph.ps1 -PackageDirectory release/packages/public-libraries -Version $env:AETHERIS_RELEASE_VERSION+ ./scripts/Test-PublicPackageConsumer.ps1 -PackageDirectory release/packages/public-libraries -Version $env:AETHERIS_RELEASE_VERSION -OutputDirectory artifacts/local/release-public-consumerpublish:- needs: release-smoke+ if: startsWith(github.ref, 'refs/tags/v') || inputs.publish == true+ needs: [release-build, release-smoke]runs-on: ubuntu-latestenvironment: productionpermissions:@@ -279,7 +232,7 @@ jobs:- uses: actions/checkout@v4- uses: actions/download-artifact@v4with:- name: preview3-release+ name: aetheris-releasepath: release- name: Authenticate to NuGet with trusted publishingid: nuget-login@@ -289,17 +242,18 @@ jobs:- name: Publish the tested NuGet packagesshell: pwshrun: |- dotnet nuget push 'release/packages/Aetheris.CLI.2.0.0-preview.3.nupkg' --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 Aetheris.CLI.' }Get-Content release/packages/public-libraries/PACKAGE_ORDER.txt | ForEach-Object {- $package = "release/packages/public-libraries/$_.2.0.0-preview.3.nupkg"+ $package = "release/packages/public-libraries/$_.${{ needs.release-build.outputs.version }}.nupkg"dotnet nuget push $package --source https://api.nuget.org/v3/index.json --api-key '${{ steps.nuget-login.outputs.NUGET_API_KEY }}' --skip-duplicateif ($LASTEXITCODE -ne 0) { throw "NuGet push failed for $_" }}+ dotnet nuget push 'release/packages/Aetheris.CLI.${{ needs.release-build.outputs.version }}.nupkg' --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 Aetheris.CLI.' }- name: Create release and upload the tested assetsenv:GH_TOKEN: ${{ github.token }}+ RELEASE_VERSION: ${{ needs.release-build.outputs.version }}run: |- gh release create "${GITHUB_REF_NAME}" --repo "${GITHUB_REPOSITORY}" --title "Aetheris ${GITHUB_REF_NAME#v}" --latest --notes-file docs/release/2.0.0-preview.3-notes.md release/Aetheris-*.zip release/aetheris-firmament-*.vsix release/SHA256SUMS.txt release/RELEASE-INVENTORY.md release/packages/*.nupkg release/packages/public-libraries/*.nupkg || \- gh release upload "${GITHUB_REF_NAME}" --repo "${GITHUB_REPOSITORY}" --clobber release/Aetheris-*.zip release/aetheris-firmament-*.vsix release/SHA256SUMS.txt release/RELEASE-INVENTORY.md release/packages/*.nupkg release/packages/public-libraries/*.nupkg- gh release edit "${GITHUB_REF_NAME}" --repo "${GITHUB_REPOSITORY}" --latest --prerelease=false --notes-file docs/release/2.0.0-preview.3-notes.md+ gh release create "v${RELEASE_VERSION}" --target "$GITHUB_SHA" --repo "${GITHUB_REPOSITORY}" --title "Aetheris ${RELEASE_VERSION}" --latest --notes-file docs/release/${{ needs.release-build.outputs.version }}-notes.md release/Aetheris-*.zip release/aetheris-firmament-*.vsix release/SHA256SUMS.txt release/RELEASE-INVENTORY.md release/packages/*.nupkg release/packages/public-libraries/*.nupkg || \+ gh release upload "v${RELEASE_VERSION}" --repo "${GITHUB_REPOSITORY}" --clobber release/Aetheris-*.zip release/aetheris-firmament-*.vsix release/SHA256SUMS.txt release/RELEASE-INVENTORY.md release/packages/*.nupkg release/packages/public-libraries/*.nupkg+ gh release edit "v${RELEASE_VERSION}" --repo "${GITHUB_REPOSITORY}" --latest --prerelease=false --notes-file docs/release/${{ needs.release-build.outputs.version }}-notes.mddiff --git a/Aetheris.CLI/Aetheris.CLI.csproj b/Aetheris.CLI/Aetheris.CLI.csprojindex ab95d74c..049521f8 100644--- a/Aetheris.CLI/Aetheris.CLI.csproj+++ b/Aetheris.CLI/Aetheris.CLI.csproj@@ -16,7 +16,7 @@<ProjectUrl>https://yuechen-li-dev.github.io/aetheris/</ProjectUrl><PackageLicenseExpression>AGPL-3.0-only</PackageLicenseExpression><PackageReadmeFile>Aetheris.CLI.README.md</PackageReadmeFile>- <PackageReleaseNotes>Preview 3: Firmament V2 semantic CAD, bounded Boss/Pocket and AP242 workflows, Sheet Metal, PMI, materials, and linear-elastic FEA. Windows x64 is the qualified release target.</PackageReleaseNotes>+ <PackageReleaseNotes>Aetheris $(Version): Firmament engineering compilation, STEP AP242, assemblies, semantic PMI, drawings, materials and bounded analysis. The core tool includes no third-party OS-native libraries; native interoperability is optional.</PackageReleaseNotes><AllowedOutputExtensionsInPackageBuildOutputFolder>.dll;.exe;.json</AllowedOutputExtensionsInPackageBuildOutputFolder></PropertyGroup>diff --git a/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj b/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csprojindex 57fa2b3a..15be8dc0 100644--- a/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj+++ b/Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj@@ -9,7 +9,7 @@</PropertyGroup><ItemGroup>- <PackageReference Include="Copeland.TS.Backend.Wgsl" Version="0.1.0-preview.1-a3.16c0ce996358af80" />+ <PackageReference Include="Copeland.TS.Backend.Wgsl" Version="$(ManagedWgslVersion)" /><PackageReference Include="Machina.Typography.OpenFont" Version="1.0.0" /><PackageReference Include="Tomlyn" Version="2.10.1" /><ProjectReference Include="..\Aetheris.Firmament.SchemaGenerator\Aetheris.Firmament.SchemaGenerator.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="false" />diff --git a/Aetheris.Web.Runtime/Program.cs b/Aetheris.Web.Runtime/Program.csindex b4b29369..0840420f 100644--- a/Aetheris.Web.Runtime/Program.cs+++ b/Aetheris.Web.Runtime/Program.cs@@ -99,7 +99,8 @@ public static partial class Programprivate static object Info() => new{- packageVersion = "2.0.0-preview.3",+ packageVersion = typeof(Program).Assembly.GetCustomAttributes(typeof(System.Reflection.AssemblyInformationalVersionAttribute), false)+ .Cast<System.Reflection.AssemblyInformationalVersionAttribute>().Single().InformationalVersion.Split('+')[0],runtimeVersion = typeof(Program).Assembly.GetName().Version?.ToString() ?? "2.0.0",contractVersion = ContractVersion,language = "Firmament",diff --git a/Aetheris.Web.Runtime/sdk/package.json b/Aetheris.Web.Runtime/sdk/package.jsonindex e5d1980c..8c2d118d 100644--- a/Aetheris.Web.Runtime/sdk/package.json+++ b/Aetheris.Web.Runtime/sdk/package.json@@ -1,6 +1,6 @@{"name": "@aetheris/cad",- "version": "2.0.0-preview.3",+ "version": "2.0.0","description": "Browser-embeddable Aetheris semantic CAD runtime","type": "module","license": "AGPL-3.0-only",diff --git a/Directory.Build.props b/Directory.Build.propsindex 7f6b1876..c93c80d1 100644--- a/Directory.Build.props+++ b/Directory.Build.props@@ -1,7 +1,7 @@<Project><PropertyGroup>- <RestoreAdditionalProjectSources Condition="Exists('$(MSBuildThisFileDirectory)artifacts/local/cir-artifact-binding/packages')">$(RestoreAdditionalProjectSources);$(MSBuildThisFileDirectory)artifacts/local/cir-artifact-binding/packages</RestoreAdditionalProjectSources>- <Version>2.0.0-preview.4</Version>+ <ManagedWgslVersion>0.1.0</ManagedWgslVersion>+ <Version>2.0.0</Version><AssemblyVersion>2.0.0.0</AssemblyVersion><FileVersion>2.0.0.0</FileVersion><InformationalVersion>$(Version)</InformationalVersion>diff --git a/demos/Aetherion.Helios/package-lock.json b/demos/Aetherion.Helios/package-lock.jsonindex ad099a1e..e1fbd340 100644--- a/demos/Aetherion.Helios/package-lock.json+++ b/demos/Aetherion.Helios/package-lock.json@@ -8,7 +8,7 @@"name": "@aetheris/helios","version": "0.1.0","dependencies": {- "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz",+ "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0.tgz","@aetheris/three-telos": "file:../../Aetheris.Web.Runtime/telos","@vitejs/plugin-react": "latest","react": "latest",@@ -49,8 +49,8 @@"license": "MIT"},"node_modules/@aetheris/cad": {- "version": "2.0.0-preview.3",- "resolved": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz",+ "version": "2.0.0",+ "resolved": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0.tgz","integrity": "sha512-AGoMhvc/+jAFqb7zDw7G7gZAPgr/DvGZ0c0NHQks4Ejtmg8qUUujp0W8IjZ6JLSIjasa8OlQRLhpPFNW5KCT0g==","license": "AGPL-3.0-only","engines": {diff --git a/demos/Aetherion.Helios/package.json b/demos/Aetherion.Helios/package.jsonindex 5097992d..91a2f50c 100644--- a/demos/Aetherion.Helios/package.json+++ b/demos/Aetherion.Helios/package.json@@ -14,7 +14,7 @@"preview": "vite preview"},"dependencies": {- "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0-preview.3.tgz",+ "@aetheris/cad": "file:../../artifacts/local/helios-sdk/aetheris-cad-2.0.0.tgz","@aetheris/three-telos": "file:../../Aetheris.Web.Runtime/telos","@vitejs/plugin-react": "latest","react": "latest",diff --git a/docs/development/reports/2026-10/RELEASE-2.0.0-CLOSEOUT.md b/docs/development/reports/2026-10/RELEASE-2.0.0-CLOSEOUT.mdnew file mode 100644index 00000000..65cd220a--- /dev/null+++ b/docs/development/reports/2026-10/RELEASE-2.0.0-CLOSEOUT.md@@ -0,0 +1,98 @@+# Aetheris 2.0.0 release qualification++Source baseline: `b05cca40ec3efd7540c647398892953299d2c136`.+This follows [Claude's blocker audit](RELEASE-2.0.0-BLOCKERS.md), preserving its+findings rather than replacing them with an assumed green status.++## Disposition and decisions++| Finding | Reproduction | Repair or decision |+|---|---|---|+| B1: incomplete public dependency graph | Confirmed: the fixed sixteen-package list omitted Fields, Cloth3D, Humanoid and PlasticShell. | Public products now derive their ProjectReference closure. A manifest gate checks identities, aligned versions, missing dependencies and publication order. The local rehearsal packed 25 packages; an empty-cache consumer restored and produced reimportable STEP. |+| B2: native CLI footprint | Already fixed before this pass. | Retain the native-asset build/pack guards. Drawing Notes use PDF.js; SQLite and 3DM are optional adapters. Do not reintroduce PDFium/Skia to support raster previews. |+| B3: unpublished/prerelease shader graph | Confirmed. | Publish all seven managed Copeland compiler dependencies at 0.1.0 and pin Firmament to that public version. Remove automatic private-feed injection and CI sibling checkout. |+| B4: preview-only release lane | Confirmed. | Product/SDK version is 2.0.0; release tooling derives the version from props, validates a tag against it, tests exact staged package bytes on Windows/Linux, and only publishes on a tag or explicit publish input. Manual rehearsal defaults to no publication. |+| S1: ignored intent | Confirmed: Extrude, assembly root/Semantic, WireForm, SectionChain Point2/Line2/Path/Loop and wrong coordinate units. | Consumption checks belong to their actual readers, using shared AST fields and existing spatial metadata. Also close occurrence fields, standalone port publications, Span fields, Modify fields, prism offsets, semantic Require and projected PMI before their erasure. |+| S2: validate/build route split | Confirmed with lowercase native model: rejected validation, successful build and wrong summary owner. | One command-level domain selector; case-only native root normalization; existing lowerers retain execution authority. Legacy solid grammar remains separate. |+| S3: diagnostics | Reproduced missing-file raw errors, wrong units and vague scale failures. | Missing-file failures now use the structured frontend diagnostic shape. Extrude dimensions identify required lengths; precision-incompatible primitive dimensions reject at the field owner. Wire field errors include readable explanations. Capability errors remain distinct from syntax failures. |+| S4: expensive engineering preflight | Retained as a performance limitation. | Do not skip orientation, pcurve or import safety to shorten validation. A faster orientation witness needs its own measured kernel change after release. Parse-only validation remains explicitly limited. |++D1: publish the existing complete graph at product versions, with experimental+status retained in the Cloth3D/Humanoid documentation. Avoid a release-time module+split that would alter current compilation ownership. Fields and PlasticShell+retain their existing bounded contracts.++D2: keep the core managed and optional native interoperability separate. This+removes the reason to split the core tool into third-party-native RID packages.+D3: use the published stable Copeland 0.1.0 family, not the private preview feed.+D4: qualify Windows x64 and Linux x64 CLI use; the desktop ZIP targets Windows x64.+Do not claim macOS qualification from portability alone.++D5: retain bare millimetres only in already admitted compatibility positions;+explicit angles cannot become lengths. WireForm directions are dimensionless,+while historical bare Origin components retain millimetres. D6: PascalCase+constructs, camelCase built-in fields and lowercase connectives are preferred;+established aliases normalize at syntax positions without renaming domain data.+D7: close materialized built-in intent rather than disclaim silent geometry loss.+Unused reusable recipes still defer material capability checks until concrete+specialization; authored Record/Concept publications and named station keys are+not a fixed built-in field dictionary.++## Managed compiler publication++Copeland release source: `70b6cbe742ecfb2947c9c6a31cfa8e1d3a89067b`.+[Publication run](https://github.com/yuechen-li-dev/Copeland/actions/runs/40065426723)+built the package family on Windows, consumed the same package bytes on Linux,+and published with NuGet trusted publishing. All 1,394 compiler tests passed.+The isolated public-only consumer checked deterministic WGSL, changed-source+semantics, graphics stage/depth contracts and invalid-source rejection.++[Release tooling PR](https://github.com/yuechen-li-dev/Copeland/pull/95) is separate+from the already completed publication. Its unrelated TinyFarm check currently+fails because Aurelian.Combat references a sibling Dominatus checkout absent on+the runner; the managed compiler release jobs do not use that game graph. This+pass does not bypass that check or rewrite the game integration.++A local cache audit found one stale Copeland.TS 0.1.0 DLL. Final Aetheris+qualification therefore uses a fresh public NuGet cache, not the global cache.+No user cache files were deleted.++## Compatibility and diagnostic contract++Initial stricter checks exposed legitimate provenance metadata, direct WireForm+Origin/Tangent/Up fields, Close path steps, nested Struct wire templates, inline+Profile boundary declarations and typed assembly exposure aliases. Each remains+admitted by its actual owner. No fixture was edited to make a check pass.++The parser now distinguishes the standalone Reverse value from unary Reverse+with an operand. This preserves the orientation of geometric Spans when an AST+field reader replaces text extraction. Offset aliases retain Along/Axis/Direction+and Termination/Extent, reject conflicts, and require whole-field consumption.+No geometry algorithm, fillet planner, tessellator or STEP orientation resolver+was changed.++CLI diagnostics carry code, severity, explanation, source file, stage and source+location when available. Missing-file diagnostics have no invented span. Legacy+and expanded producers still disclose enclosing locations where exact provenance+is unavailable; this release does not claim a complete expansion source map.++## Qualification evidence++Raw evidence defaults to ignored `artifacts/local/release-2-readiness/`.+The retained `qualify-release-corpus.py` runs real validate/build commands and+compares STEP hashes with a frozen baseline. It records target-specific refusal+rather than misclassifying Scene/Garment mesh workflows or Drawing/Analysis+artifact-directory requirements as STEP regressions.++`test-support/ReleaseAdmissionProbe` inserts fields at AST-owned declaration and+object boundaries, uses the real CLI, and deletes temporary sibling specimens in+finally blocks. Accepted probes require classification: authored publications,+named mappings and unused definitions are not automatically correctness defects.+Replay fails if it accidentally matches no specimens.++The first broad run covered 3,317 declaration bodies. Repairs were followed by+replay and full regression; the final counts and geometry-parity verdict are+recorded below only after completion.++Qualification is in progress. No Aetheris stable tag has been published by this+pass while the final gates remain open.diff --git a/docs/public/fields.md b/docs/public/fields.mdindex 4a3b3517..6e915054 100644--- a/docs/public/fields.md+++ b/docs/public/fields.md@@ -23,7 +23,8 @@ dotnet pack Aetheris.Fields -c Release -o artifacts/local/field-packages```Building the complete Firmament/application stack still restores its explicitly-pinned `Copeland.TS.Backend.Wgsl` package family. That is a downstream display+pinned `Copeland.TS.Backend.Wgsl` 0.1.0 package family from nuget.org.+A Copeland checkout or private package feed is not required to build Aetheris. That is a downstream displaycompiler dependency, not a dependency of native fields. Applications consumingonly fields need no Copeland checkout or compiler packages.diff --git a/docs/public/reference/release-notes.md b/docs/public/reference/release-notes.mdindex b62defad..730bfbce 100644--- a/docs/public/reference/release-notes.md+++ b/docs/public/reference/release-notes.md@@ -1,64 +1,38 @@-# Aetheris 2.0.0-preview.3 release notes--Preview 3 is the feature-frozen Windows x64 release of Aetheris's integrated semantic CAD workflow.--## Firmament V2--- Semantic CAD authoring with typed Records, Templates, Static specialization, finite tables and arrays, `with`, `Require`, named concepts, and explicit engineering references.-- Stable CLI validation/build diagnostics: admitted intent is lowered and unsupported intent is rejected instead of silently omitted.--## Geometry--- Bounded material offsets: typed `AddOffset<Prism>` / `RemoveOffset<Prism>` authoring through exact Profile/Compose section-stack construction, with explicit target/support/termination/authorized-region evidence and fail-closed safety diagnostics. Cylinder and Sphere remain explicitly unqualified pending bounded curved-topology builders.--- Bounded analytic and prismatic modeling: named primitives and profiles, semantic holes, slots and patterns, admitted chamfer/fillet routes, hollow/lattice routes, and deterministic AP242 output.-- First-class connected finite Boss and finite-depth Pocket operations on the documented Compose host, with explicit through-depth and minimum-floor rejection.-- Parser-backed Sphere, Cone, and Torus single-solid AP242 routes. This is not general freeform or Boolean authoring.--## Sheet Metal--- Authored base, flange/bend, and planar-opening workflows with material identity, K-factor, semantic regions, DFM evidence, formed STEP, flat STEP, and SVG.-- Bounded imported reconstruction remains experimental and reports partial status rather than inventing authoritative intent.--## STEP AP242 and PMI--- Deterministic single-body import/export on the qualified classes.-- Semantic datums, toleranced diameters, manufacturing dimensions, position controls, engineering annotations, and qualified geometry associations in AP242 workflows.-- Unsupported PMI families remain explicit in diagnostics and the support matrix.--## Cadmata--- Interactive geometry inspection, model switching, selection, PMI filtering, datum/feature interaction, geometry-to-PMI discovery, and presentation-only callout movement.-- Production hosting is included in the Windows bundle; the standalone CLI tool does not include Cadmata.--## Materials--- Four deployed Standard Library catalog entries with typed property provenance.-- Material resolution is qualified for authored Sheet Metal and Firmament FEA. Ordinary prismatic CAD STEP does not persist a general solid-material designation.--## FEA--- Bounded linear-elastic isotropic analysis over native Firmament geometry and qualified `inlineSTEP` single bodies.-- Fixed component constraints, total-resultant Force, displacement/strain/stress/reaction results, cut-cell/vector-lattice lowering, and structured convergence/equilibrium evidence.-- The public A36 cantilever reports approximately `25.06 µm` maximum displacement versus approximately `24.7 µm` from simple beam theory. This is a narrow sanity witness, not general mechanics validation.--## Forge interoperability--- Forge Host Protocol v1 list/describe/invoke with structured diagnostics and deterministic file artifacts.-- The release ships a NativeAOT `win-x64` host and small qualified Python, Go, Rust, and TypeScript clients.-- Protocol version `1` is independent of Aetheris version `2.0.0-preview.3`.--## Documentation and packaging--- Publication-ready public guides and qualified examples are included in the Windows ZIP alongside licenses, third-party notices, material data, Cadmata, and Forge clients.-- Sixteen version-aligned public library packages, the CLI tool package, and the independently versioned `0.3.0-preview.3` VSIX are staged as release assets.-- Release archive and NuGet normalization provides a reproducible generation path and canonical SHA-256 inventory.--## Known limitations--- Only `win-x64` release binaries are qualified.-- Geometry is bounded: no general loft, helix, freeform feature family, or arbitrary public solid Boolean authoring.-- Imported STEP containment, source-unit preservation, Sheet Metal opening families, material persistence, and the generic tessellated mass estimate have the boundaries described in [known issues](known-issues.md).-- Sheet Metal and FEA cover the documented manufacturing and linear-elastic subsets, not general formed-feature or physics systems.--See the [supported-features matrix](supported-features.md) for the precise public contract.+# Aetheris 2.0.0 release notes++Aetheris compiles Firmament engineering source into reviewable artifacts. The+managed CLI runs in local development and CI; the Windows bundle also includes+Cadmata and the NativeAOT Forge Host.++```powershell+dotnet tool install --global Aetheris.CLI --version 2.0.0+aetheris validate fixtures/Canonical/Learn/01-plate.firmament --json+aetheris build fixtures/Canonical/Learn/01-plate.firmament --out artifacts/local/first-plate.step --json+```++Use the first-plate source from the [learning guide](../learn/01-first-part.md).+The compiler supports bounded exact parts, assemblies, Sheet Metal, semantic+PMI, STEP import/export, mesh export, drawings and analysis. See the+[supported features](supported-features.md) and [known issues](known-issues.md)+for the actual capability contracts.++Validation and build share domain selection. Unknown fields and unsupported+units reject at their owning binders. Native V2 `model` is a case alias for+`Model`; historical serialized inputs and `solid` grammar retain their separate+compatibility boundaries. Normal validation includes required engineering+preflight; parse-only validation explicitly reports its limited level.++The managed tool is qualified on Windows x64 and Linux x64. The self-contained+desktop bundle targets Windows x64. The public NuGet library set includes its+full dependency closure and pins Copeland's managed VTS/WGSL compiler to 0.1.0.+No Copeland checkout or private feed is needed. The core CLI has no third-party+OS-native dependencies; SQLite and 3DM remain optional adapters. Drawing Notes+use pinned PDF.js browser assets; PDF drawing output remains managed.++Forge Host Protocol v1 and the VS Code extension are independently versioned.+Cloth3D and Humanoid packages remain experimental. STEP geometry and explicitly+authored semantic PMI retain their engineering authority; assembly export does+not implicitly promote part PMI into assembly PMI.++Release assets include an inventory and SHA-256 checksums. See the+[bundle guide](../release-bundle.md) for layout and use.diff --git a/docs/public/release-bundle.md b/docs/public/release-bundle.mdindex 1c6a0586..80015409 100644--- a/docs/public/release-bundle.md+++ b/docs/public/release-bundle.md@@ -1,6 +1,6 @@-# Aetheris 2.0.0-preview.3 Windows bundle+# Aetheris Windows bundle-This bundle is the qualified `win-x64` Preview 3 product. Run commands from the `Aetheris-win-x64` directory.+This bundle is the `win-x64` product distribution. Run commands from the `Aetheris-win-x64` directory.```powershell.\aetheris.exe --help@@ -14,6 +14,6 @@ This bundle is the qualified `win-x64` Preview 3 product. Run commands from theThe complete public guide is under `docs/public`, executable Firmament examples are under `fixtures`, foreign-language Forge clients are under `samples/forge-interop-x1`, and the deployed Standard Library material catalog is under `Materials`.-The ZIP is the complete end-user distribution. `packages/Aetheris.CLI.2.0.0-preview.3.nupkg`, the 16 public library packages, and `aetheris-firmament-0.3.0-preview.3.vsix` are published as separate release assets rather than duplicated inside the runtime tree. Verify downloaded binary assets against the release's `SHA256SUMS.txt`.+The ZIP is the complete end-user distribution. The `Aetheris.CLI` tool package, its dependency-closed public library set, and `aetheris-firmament-0.3.0-preview.3.vsix` are published as separate release assets rather than duplicated inside the runtime tree. Verify downloaded binary assets against the release's `SHA256SUMS.txt`.-Cadmata and the NativeAOT Forge Host are included. The standalone CLI NuGet tool does not include Cadmata. Preview 3 is qualified only for Windows x64 and intentionally supports bounded geometry, Sheet Metal, PMI, FEA, and STEP-import classes; read `docs/public/reference/supported-features.md` and `docs/public/reference/known-issues.md` before relying on a boundary case.+Cadmata and the NativeAOT Forge Host are included. The standalone CLI NuGet tool does not include Cadmata. The desktop bundle targets Windows x64; the managed CLI also runs on Linux x64. Aetheris supports bounded geometry, Sheet Metal, PMI, FEA, and STEP-import classes; read `docs/public/reference/supported-features.md` and `docs/public/reference/known-issues.md` before relying on a boundary case.diff --git a/docs/release/2.0.0-notes.md b/docs/release/2.0.0-notes.mdnew file mode 100644index 00000000..314ae500--- /dev/null+++ b/docs/release/2.0.0-notes.md@@ -0,0 +1,52 @@+# Aetheris 2.0.0++Aetheris compiles Firmament source into engineering artifacts. Source can be+reviewed in Git and built in CI; the same compiler supplies validation and+structured diagnostics to the CLI, SDK and CAD application.++## Installation and artifacts++- Install the managed tool with `dotnet tool install --global Aetheris.CLI --version 2.0.0` using .NET 10.+- Windows x64 has a self-contained ZIP including Cadmata and the NativeAOT Forge Host.+- The portable CLI package is qualified on Windows x64 and Linux x64. Other platforms are not claimed as qualified by this release.+- The public library package set includes its complete Aetheris project dependency closure. Copeland's managed VTS/WGSL compiler family is pinned to public version 0.1.0; no sibling checkout or private feed is required.+- Verify artifacts against SHA256SUMS.txt and RELEASE-INVENTORY.md. Forge protocol and VS Code extension versions are independent of the product version.++The core CLI carries no third-party OS-native geometry, SQLite, PDFium, Skia or+Rhino runtime. PDF drawing generation remains managed. Drawing Notes use pinned+PDF.js browser assets. SQLite material storage and 3DM interoperability are+optional adapters; the latter has its own command-line tool.++## Frontend integrity++Validation and build share command-level domain selection. Native V2 `model`+is a case alias for `Model`; the existing serialized and `solid`-grammar legacy+boundaries remain explicit. Unknown fields reject at their owning readers,+including assembly occurrences and Semantic publications, WireForm operations,+SectionChain construction guides, semantic requirements and projected PMI.+Wrong-dimensional profile coordinates reject instead of silently becoming+millimetres. Diagnostics retain codes and messages through the CLI JSON contract.++This release preserves the existing bounded geometry capabilities. Unsupported+operations remain errors; it does not promise arbitrary BRep booleans, general+edge blending or unrestricted STEP surgery. Assembly exports include assembly+PMI explicitly authored at assembly scope; part PMI is not implicitly promoted.+See [supported features](../public/reference/supported-features.md) and+[known issues](../public/reference/known-issues.md).++## Experimental APIs++Cloth3D, Humanoid and experimental module APIs are included at the product+version so the published graph restores completely. Their behavior remains+experimental, as documented under docs/public/experimental; a package version+is not a claim that those workflows are production-qualified. Fields and+PlasticShell retain their documented bounded capability contracts.++## Validation cost and limits++Normal validation performs the preflight required by its domain. Swept and+B-spline-heavy models can take seconds; orientation and interchange safety+checks have not been removed to improve timing. Parse-only validation is+explicitly limited and does not prove engineering build success. Original-source+mapping after expansion is still incomplete; diagnostics disclose enclosing+locations when exact provenance is unavailable.diff --git a/docs/release/Aetheris.CLI.README.md b/docs/release/Aetheris.CLI.README.mdindex 37223cd9..bd11c094 100644--- a/docs/release/Aetheris.CLI.README.md+++ b/docs/release/Aetheris.CLI.README.md@@ -4,7 +4,7 @@Firmament exact-CAD and STEP AP242 workflow.```powershell-dotnet tool install --global Aetheris.CLI --prerelease+dotnet tool install --global Aetheris.CLI --version 2.0.0aetheris --help```@@ -25,8 +25,8 @@ download the Windows bundle from the GitHub release for package-relative Cadmatadiscovery and the complete desktop experience.See the [Aetheris manual](https://yuechen-li-dev.github.io/aetheris/) for the-supported Firmament surface and Preview 3 limitations.+supported Firmament surface and capability limits.-The core CLI bundles no third-party OS-native libraries. The .NET runtime/apphost is still required (or included in self-contained distributions). 3DM inspection and recovery are supplied by the separate `Aetheris.ThreeDm.CLI` tool (`dotnet tool install --global Aetheris.ThreeDm.CLI --prerelease`), which includes native Rhino3dm. The built-in material catalog is managed; custom SQLite catalogs use the optional `Aetheris.Materials.Sqlite` library.+The core CLI bundles no third-party OS-native libraries. The .NET runtime/apphost is still required (or included in self-contained distributions). 3DM inspection and recovery are supplied by the separate `Aetheris.ThreeDm.CLI` tool (`dotnet tool install --global Aetheris.ThreeDm.CLI --version 2.0.0`), which includes native Rhino3dm. The built-in material catalog is managed; custom SQLite catalogs use the optional `Aetheris.Materials.Sqlite` library.Drawing Notes previews and crops render locally in the browser using bundled PDF.js assets; no CDN or native PDF renderer is required. Headless PNG render/crop commands require `--renderer <path-to-pdftoppm>`, selecting an external Poppler installation explicitly. PDF drawing generation itself remains managed vector output and needs no rasterizer.diff --git a/docs/release/Aetheris.Libraries.README.md b/docs/release/Aetheris.Libraries.README.mdindex 2204d4ca..7234bd90 100644--- a/docs/release/Aetheris.Libraries.README.md+++ b/docs/release/Aetheris.Libraries.README.md@@ -15,8 +15,13 @@ KernelSDK extensions are Safe by default at the Aetheris capability boundary.Extensions declaring `UNSAFE` require explicit host consent. Because extensionsexecute in-process, this API policy is not a cryptographic CLR sandbox.-Preview 3 targets .NET 10. Aetheris is licensed under the GNU Affero General+Aetheris targets .NET 10. Aetheris is licensed under the GNU Affero GeneralPublic License v3.0 (`AGPL-3.0`); third-party assets retain their respectivelicenses and provenance. Alternative licensing is available on request.Documentation and examples are available at<https://yuechen-li-dev.github.io/aetheris/>.++The stable 2.0.0 set includes the complete project dependency closure. Firmament+restores the public managed Copeland VTS/WGSL compiler family at 0.1.0. A sibling+checkout and a private NuGet feed are not required. Cloth3D and Humanoid remain+experimental APIs even though their package versions align with the product.diff --git a/scripts/Test-PublicPackageConsumer.ps1 b/scripts/Test-PublicPackageConsumer.ps1new file mode 100644index 00000000..f6aaccf6--- /dev/null+++ b/scripts/Test-PublicPackageConsumer.ps1@@ -0,0 +1,30 @@+param(+ [Parameter(Mandatory)][string]$PackageDirectory,+ [Parameter(Mandatory)][string]$OutputDirectory,+ [string]$Version = '2.0.0'+)+$ErrorActionPreference = 'Stop'+$env:MSBUILDDISABLENODEREUSE = '1'+$root = Split-Path $PSScriptRoot -Parent+$feed = (Resolve-Path -LiteralPath $PackageDirectory).Path+$output = [IO.Path]::GetFullPath($OutputDirectory)+if (Test-Path -LiteralPath $output) { throw 'Use a fresh consumer directory.' }+New-Item -ItemType Directory -Path $output | Out-Null+foreach ($name in @('PublicPackageSmoke.csproj', 'Program.cs')) {+ Copy-Item -LiteralPath (Join-Path $root "test-support/PublicPackageSmoke/$name") -Destination $output+}+$escaped = [Security.SecurityElement]::Escape($feed)+[IO.File]::WriteAllText((Join-Path $output 'NuGet.Config'), "<configuration><packageSources><clear/><add key='candidate' value='$escaped'/><add key='nuget.org' value='https://api.nuget.org/v3/index.json'/></packageSources></configuration>")+$cache = Join-Path $output 'packages'+$project = Join-Path $output 'PublicPackageSmoke.csproj'+dotnet restore $project --configfile (Join-Path $output 'NuGet.Config') --packages $cache --no-cache -m:1 -nr:false -p:AetherisReleaseVersion=$Version+if ($LASTEXITCODE -ne 0) { throw 'Empty-cache public consumer restore failed.' }+dotnet build $project -c Release --no-restore -m:1 -nr:false -p:UseSharedCompilation=false -p:RestorePackagesPath=$cache -p:AetherisReleaseVersion=$Version+if ($LASTEXITCODE -ne 0) { throw 'Public consumer build failed.' }+$previousVersion = $env:AETHERIS_RELEASE_VERSION+try {+ $env:AETHERIS_RELEASE_VERSION = $Version+ dotnet (Join-Path $output 'bin/Release/net10.0/PublicPackageSmoke.dll')+ if ($LASTEXITCODE -ne 0) { throw 'Public consumer execution failed.' }+}+finally { $env:AETHERIS_RELEASE_VERSION = $previousVersion }diff --git a/scripts/Test-PublicPackageGraph.ps1 b/scripts/Test-PublicPackageGraph.ps1new file mode 100644index 00000000..779160ae--- /dev/null+++ b/scripts/Test-PublicPackageGraph.ps1@@ -0,0 +1,37 @@+param(+ [Parameter(Mandatory)][string]$PackageDirectory,+ [Parameter(Mandatory)][string]$Version+)+$ErrorActionPreference = 'Stop'+Add-Type -AssemblyName System.IO.Compression.FileSystem+$root = (Resolve-Path -LiteralPath $PackageDirectory).Path+$order = @(Get-Content -LiteralPath (Join-Path $root 'PACKAGE_ORDER.txt'))+if ($order.Count -eq 0 -or @($order | Select-Object -Unique).Count -ne $order.Count) { throw 'Package order must contain unique package identities.' }+$available = @{}+foreach ($file in Get-ChildItem -LiteralPath $root -Filter '*.nupkg' -File) {+ $zip = [IO.Compression.ZipFile]::OpenRead($file.FullName)+ try {+ $entry = @($zip.Entries | Where-Object FullName -Like '*.nuspec')+ if ($entry.Count -ne 1) { throw "Expected one manifest in $($file.Name)." }+ $reader = [IO.StreamReader]::new($entry[0].Open())+ try { [xml]$manifest = $reader.ReadToEnd() } finally { $reader.Dispose() }+ $metadata = $manifest.package.metadata+ $id = [string]$metadata.id+ if ($metadata.version -ne $Version -or $file.Name -ne "$id.$Version.nupkg") { throw "Wrong identity/version in $($file.Name)." }+ if ($available.ContainsKey($id)) { throw "Duplicate package $id." }+ $available[$id] = $metadata+ }+ finally { $zip.Dispose() }+}+if ($available.Count -ne $order.Count) { throw 'Manifest count differs from package order.' }+$visited = [Collections.Generic.HashSet[string]]::new([StringComparer]::Ordinal)+foreach ($id in $order) {+ if (-not $available.ContainsKey($id)) { throw "Missing public package $id." }+ foreach ($dependency in $available[$id].SelectNodes('.//dependency')) {+ if ($dependency.id -notlike 'Aetheris.*') { continue }+ if (-not $visited.Contains($dependency.id)) { throw "$id depends on missing or unordered package $($dependency.id)." }+ if ($dependency.version -ne $Version) { throw "$id has a mismatched dependency: $($dependency.id) $($dependency.version)." }+ }+ [void]$visited.Add($id)+}+Write-Host "Verified dependency-closed public graph: $($order.Count) packages at $Version."diff --git a/scripts/finalize-publication.ps1 b/scripts/finalize-publication.ps1index 8f93dd4b..37c20442 100644--- a/scripts/finalize-publication.ps1+++ b/scripts/finalize-publication.ps1@@ -15,8 +15,9 @@ $publicPackageDestination = Join-Path $releaseRoot "packages/public-libraries"New-Item -ItemType Directory -Force -Path $publicPackageDestination | Out-Null$publicPackages = @(Get-ChildItem -LiteralPath $publicLibrariesRoot -Filter "*.nupkg" -File | Sort-Object Name)-if ($publicPackages.Count -ne 16) {- throw "Expected 16 public library packages in '$publicLibrariesRoot', found $($publicPackages.Count)."+$expectedIds = @(Get-Content (Join-Path $publicLibrariesRoot 'PACKAGE_ORDER.txt'))+if ($publicPackages.Count -ne $expectedIds.Count) {+ throw "Expected $($expectedIds.Count) public packages in '$publicLibrariesRoot', found $($publicPackages.Count)."}foreach ($package in $publicPackages) {@@ -49,7 +50,7 @@ $checksumLines = $releaseHashes | ForEach-Object { "$($_.Sha256) $($_.Path)" }Set-Content -LiteralPath (Join-Path $releaseRoot "SHA256SUMS.txt") -Value $checksumLines -Encoding utf8NoBOM$inventoryLines = @(- "# Preview 3 release inventory"+ "# Aetheris release inventory""""Generated from the staged publication directory. Hashes use SHA-256."""@@ -59,7 +60,7 @@ $inventoryLines = @($inventoryLines += $releaseHashes | ForEach-Object { "| ``$($_.Path)`` | $($_.Bytes) | ``$($_.Sha256)`` |" }$inventoryLines += @(""- "The inventory contains the Windows x64 bundle, Firmament VSIX, CLI package, and all 16 public library packages."+ "The inventory contains the Windows x64 bundle, Firmament VSIX, CLI package, and all $($publicPackages.Count) public packages.")Set-Content -LiteralPath (Join-Path $releaseRoot "RELEASE-INVENTORY.md") -Value $inventoryLines -Encoding utf8NoBOMdiff --git a/scripts/package-public-libraries.ps1 b/scripts/package-public-libraries.ps1index e069582a..5c1d5b2d 100644--- a/scripts/package-public-libraries.ps1+++ b/scripts/package-public-libraries.ps1@@ -1,9 +1,10 @@param(- [string]$Version = "2.0.0-preview.3",- [string]$OutputDirectory = "artifacts/packages/public-libraries"+ [string]$Version = "2.0.0",+ [string]$OutputDirectory = "artifacts/local/public-libraries")$ErrorActionPreference = "Stop"+$env:MSBUILDDISABLENODEREUSE = '1'Add-Type -AssemblyName System.IO.Compression.FileSystem$repoRoot = Split-Path -Parent $PSScriptRoot$outputPath = [IO.Path]::GetFullPath((Join-Path $repoRoot $OutputDirectory))@@ -54,8 +55,8 @@ if (Test-Path -LiteralPath $outputPath) {New-Item -ItemType Directory -Path $outputPath | Out-Null}-# Topological order is also the intended NuGet publication order.-$projects = @(+# Explicit public products; derive their complete project dependency closure.+$roots = @("Aetheris.Kernel.Core/Aetheris.Kernel.Core.csproj","Aetheris.Modules/Aetheris.Modules.csproj","Aetheris.Geometry/Aetheris.Geometry.csproj",@@ -71,17 +72,37 @@ $projects = @("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"+ "Aetheris.Forge.KernelSDK/Aetheris.Forge.KernelSDK.csproj",+ "Aetheris.Drawing/Aetheris.Drawing.csproj",+ "Aetheris.Sculpture/Aetheris.Sculpture.csproj",+ "Aetheris.Materials.Sqlite/Aetheris.Materials.Sqlite.csproj",+ "Aetheris.ThreeDm/Aetheris.ThreeDm.csproj",+ "Aetheris.ThreeDm.CLI/Aetheris.ThreeDm.CLI.csproj")+$projects = [Collections.Generic.List[string]]::new()+function Visit-PublicProject([string]$relative) {+ $path = [IO.Path]::GetFullPath((Join-Path $repoRoot $relative))+ $relative = [IO.Path]::GetRelativePath($repoRoot, $path).Replace('\', '/')+ if ($projects.Contains($relative)) { return }+ [xml]$project = Get-Content -LiteralPath $path -Raw+ foreach ($reference in $project.Project.ItemGroup.ProjectReference) {+ if ($reference.Include -and $reference.ReferenceOutputAssembly -ne 'false') {+ $dependency = [IO.Path]::GetFullPath((Join-Path (Split-Path $path -Parent) $reference.Include))+ Visit-PublicProject ([IO.Path]::GetRelativePath($repoRoot, $dependency))+ }+ }+ $projects.Add($relative)+}+foreach ($root in $roots) { Visit-PublicProject $root }Push-Location $repoRoottry {foreach ($project in $projects) {# The package payload must not inherit assemblies from an earlier commit- # or a RID-specific publish. Rebuild every public package payload and+ # or a RID-specific publish. Build every public package payload and# exclude debug symbols so the staged bytes reflect this invocation.- dotnet pack $project --configuration Release --output $outputPath -t:Rebuild `- -p:PackageVersion=$Version -p:DebugType=None -p:DebugSymbols=false+ dotnet pack $project --configuration Release --output $outputPath -m:1 -nr:false -p:UseSharedCompilation=false `+ -p:Version=$Version -p:PackageVersion=$Version -p:DebugType=None -p:DebugSymbols=falseif ($LASTEXITCODE -ne 0) {throw "dotnet pack failed for $project"}@@ -98,6 +119,7 @@ try {throw "Expected $($projects.Count) packages but found $($packages.Count)."}$packages | ForEach-Object { Normalize-NuGetPackage $_.FullName }+ & (Join-Path $PSScriptRoot 'Test-PublicPackageGraph.ps1') -PackageDirectory $outputPath -Version $Version} finally {Pop-Location}diff --git a/scripts/package-release.ps1 b/scripts/package-release.ps1index 0a1812a0..77087e9f 100644--- a/scripts/package-release.ps1+++ b/scripts/package-release.ps1@@ -8,6 +8,7 @@ param($ErrorActionPreference = 'Stop'$PSNativeCommandUseErrorActionPreference = $true+$env:MSBUILDDISABLENODEREUSE = '1'Add-Type -AssemblyName System.IO.Compression.FileSystem$repoRoot = Split-Path -Parent $PSScriptRoot$output = [System.IO.Path]::GetFullPath((Join-Path $repoRoot $OutputDirectory))@@ -97,7 +98,7 @@ function Get-ReleaseRelativePath([string]$Root, [string]$Path) {return $canonicalPath.Substring($rootPrefix.Length)}-Remove-Item -LiteralPath $output -Recurse -Force -ErrorAction SilentlyContinue+if (Test-Path -LiteralPath $output) { throw 'Use a fresh release output directory.' }New-Item -ItemType Directory -Force -Path $stage, (Join-Path $output 'packages') | Out-NullPush-Location (Join-Path $repoRoot 'aetheris.client')@@ -117,13 +118,13 @@ finally { Pop-Location }# Release binaries must not inherit compiler state from an earlier publish with# different properties (notably PublishAot). Start the managed release graph# from a clean configuration so identical inputs produce identical archives.-dotnet clean (Join-Path $repoRoot 'Aetheris.slnx') -c Release+dotnet clean (Join-Path $repoRoot 'Aetheris.slnx') -c Release -m:1 -nr:falsedotnet publish (Join-Path $repoRoot 'Aetheris.CLI/Aetheris.CLI.csproj') -c Release -r win-x64 --self-contained true -m:1 -nr:false -p:UseSharedCompilation=false -t:Rebuild -p:Version=$Version -p:DebugType=None -p:DebugSymbols=false -o (Join-Path $stage 'Aetheris-win-x64')& (Join-Path $PSScriptRoot 'Test-CoreCliPayload.ps1') -AssetsPath (Join-Path $repoRoot 'Aetheris.CLI/obj/project.assets.json') -PublishDirectory (Join-Path $stage 'Aetheris-win-x64')-dotnet publish (Join-Path $repoRoot 'Aetheris.Forge.Host/Aetheris.Forge.Host.csproj') -c Release -r win-x64 --self-contained true -t:Rebuild -p:PublishAot=true -p:Version=$Version -p:DebugType=None -p:DebugSymbols=false -o (Join-Path $stage 'Aetheris-win-x64/forge-host')+dotnet publish (Join-Path $repoRoot 'Aetheris.Forge.Host/Aetheris.Forge.Host.csproj') -c Release -r win-x64 --self-contained true -m:1 -nr:false -p:UseSharedCompilation=false -t:Rebuild -p:PublishAot=true -p:Version=$Version -p:DebugType=None -p:DebugSymbols=false -o (Join-Path $stage 'Aetheris-win-x64/forge-host')Normalize-PeTimestamps (Join-Path $stage 'Aetheris-win-x64/forge-host/Aetheris.Forge.Host.exe')-dotnet publish (Join-Path $repoRoot 'Aetheris.Server/Aetheris.Server.csproj') -c Release -r win-x64 --self-contained true -t:Rebuild -p:Version=$Version -p:DebugType=None -p:DebugSymbols=false -o (Join-Path $stage 'Aetheris-win-x64/cadmata')+dotnet publish (Join-Path $repoRoot 'Aetheris.Server/Aetheris.Server.csproj') -c Release -r win-x64 --self-contained true -m:1 -nr:false -p:UseSharedCompilation=false -t:Rebuild -p:Version=$Version -p:DebugType=None -p:DebugSymbols=false -o (Join-Path $stage 'Aetheris-win-x64/cadmata')$endpoints = Join-Path $stage 'Aetheris-win-x64/cadmata/Cadmata.staticwebassets.endpoints.json'if (Test-Path -LiteralPath $endpoints) {$canonicalEndpoints = [Regex]::Replace([IO.File]::ReadAllText($endpoints),@@ -235,5 +236,5 @@ $inventory = @($inventory += $releaseHashes | ForEach-Object { "| ``$($_.Path)`` | $($_.Bytes) | ``$($_.Sha256)`` |" }$inventory += @("",- "The 16 public library packages are generated separately by ``scripts/package-public-libraries.ps1``. Public documentation is in ``docs/public`` and is also included in the Windows ZIP.")+ "The public package dependency closure is generated separately by ``scripts/package-public-libraries.ps1``. Public documentation is in ``docs/public`` and is also included in the Windows ZIP.")[IO.File]::WriteAllLines((Join-Path $output 'RELEASE-INVENTORY.md'), [string[]]$inventory, [Text.UTF8Encoding]::new($false))diff --git a/scripts/prepare-managed-wgsl.ps1 b/scripts/prepare-managed-wgsl.ps1index 1bf627c9..3e3d8d7d 100644--- a/scripts/prepare-managed-wgsl.ps1+++ b/scripts/prepare-managed-wgsl.ps1@@ -28,7 +28,8 @@ foreach ($file in $files) {}$manifest = ($sourceHashes.GetEnumerator() | ForEach-Object { $_.Key + ':' + $_.Value }) -join "`n"$hash = [Convert]::ToHexString([Security.Cryptography.SHA256]::HashData([Text.Encoding]::UTF8.GetBytes($manifest))).ToLowerInvariant()-$version = '0.1.0-preview.1-a3.' + $hash.Substring(0,16)+[xml]$properties = Get-Content (Join-Path $repo 'Directory.Build.props') -Raw+$version = [string]$properties.Project.PropertyGroup.ManagedWgslVersion$pin = Join-Path $repo 'scripts/managed-wgsl-source-pin.txt'if (-not (Test-Path $pin)) { throw 'Managed WGSL producer source pin is missing.' }if ((Get-Content $pin -Raw).Trim() -ne $hash) { throw "Managed WGSL producer source differs from the reviewed source pin: actual $hash." }@@ -38,6 +39,6 @@ if ($VerifyOnly) { return }$output = Join-Path $repo 'artifacts/local/cir-artifact-binding/packages'New-Item -ItemType Directory -Force $output | Out-Nullforeach ($project in $projects | Sort-Object) {- dotnet pack $project -c Release -o $output "-p:PackageVersion=$version" "-p:Version=$version" --nologo+ dotnet pack $project -c Release -m:1 -nr:false -p:UseSharedCompilation=false -o $output "-p:PackageVersion=$version" "-p:Version=$version" --nologoif ($LASTEXITCODE -ne 0) { throw "Managed WGSL dependency pack failed: $project" }}diff --git a/test-support/PublicPackageSmoke/Program.cs b/test-support/PublicPackageSmoke/Program.csindex 2c2a03b7..12749cf6 100644--- a/test-support/PublicPackageSmoke/Program.cs+++ b/test-support/PublicPackageSmoke/Program.cs@@ -19,7 +19,7 @@ foreach (var assemblyName in packageAssemblies).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;- if (version is null || !version.StartsWith("2.0.0-preview.3", StringComparison.Ordinal))+ if (version is null || version.Split('+')[0] != (Environment.GetEnvironmentVariable("AETHERIS_RELEASE_VERSION") ?? "2.0.0")){throw new InvalidOperationException($"{assemblyName} reported unexpected version '{version}'.");}@@ -30,7 +30,7 @@ foreach (var assemblyName in packageAssemblies)var material = new MaterialResolver().Resolve("Standard.Materials.Aluminum.5052_H32");if (!material.IsSuccess || material.Material?.Identity.StableId != "aluminum/5052-h32")throw new InvalidOperationException($"Packaged material resolution failed: {material.Message}");-Console.WriteLine($"Material {material.Material.Identity.FirmamentPath} resolved from the packaged SQLite catalog.");+Console.WriteLine($"Material {material.Material.Identity.FirmamentPath} resolved from the packaged material catalog.");var host = new ForgeProtocolHost();if (host.GetHostInfo().ProtocolVersion != ForgeHostProtocol.Version || host.ListTemplates().Templates.Count == 0)diff --git a/test-support/PublicPackageSmoke/PublicPackageSmoke.csproj b/test-support/PublicPackageSmoke/PublicPackageSmoke.csprojindex c87a01ba..321c6aa3 100644--- a/test-support/PublicPackageSmoke/PublicPackageSmoke.csproj+++ b/test-support/PublicPackageSmoke/PublicPackageSmoke.csproj@@ -4,12 +4,13 @@<TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>+ <AetherisReleaseVersion Condition="'$(AetherisReleaseVersion)' == ''">2.0.0</AetherisReleaseVersion></PropertyGroup><ItemGroup>- <PackageReference Include="Aetheris.Kernel.Core" Version="2.0.0-preview.3" />- <PackageReference Include="Aetheris.Kernel.Firmament" Version="2.0.0-preview.3" />- <PackageReference Include="Aetheris.Kernel.StandardLibrary" Version="2.0.0-preview.3" />- <PackageReference Include="Aetheris.Forge.Host" Version="2.0.0-preview.3" />- <PackageReference Include="Aetheris.Forge.KernelSDK" Version="2.0.0-preview.3" />+ <PackageReference Include="Aetheris.Kernel.Core" Version="$(AetherisReleaseVersion)" />+ <PackageReference Include="Aetheris.Kernel.Firmament" Version="$(AetherisReleaseVersion)" />+ <PackageReference Include="Aetheris.Kernel.StandardLibrary" Version="$(AetherisReleaseVersion)" />+ <PackageReference Include="Aetheris.Forge.Host" Version="$(AetherisReleaseVersion)" />+ <PackageReference Include="Aetheris.Forge.KernelSDK" Version="$(AetherisReleaseVersion)" /></ItemGroup></Project>