Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Make Preview 3 CI and publication deterministic
Yuechen Li361abed4598a
diff --git a/.github/workflows/dotnet.yml b/.github/workflows/dotnet.ymlindex 06150dc7..851881fe 100644--- a/.github/workflows/dotnet.yml+++ b/.github/workflows/dotnet.yml@@ -50,7 +50,7 @@ jobs:run: ./scripts/package-public-libraries.ps1 -OutputDirectory artifacts/packages/public-libraries- uses: actions/upload-artifact@v4with:- name: public-libraries-preview2+ name: public-libraries-preview3path: artifacts/packages/public-librariesif-no-files-found: error@@ -64,7 +64,7 @@ jobs:dotnet-version: 10.0.x- uses: actions/download-artifact@v4with:- name: public-libraries-preview2+ name: public-libraries-preview3path: local-feed- name: Restore and run clean public-package consumershell: pwsh@@ -72,7 +72,7 @@ jobs:$smoke = Join-Path $env:RUNNER_TEMP 'aetheris-public-package-smoke'$packages = Join-Path $env:RUNNER_TEMP 'aetheris-public-package-cache'Copy-Item tests/PublicPackageSmoke $smoke -Recurse- dotnet restore "$smoke/PublicPackageSmoke.csproj" --source "$pwd/local-feed" --packages $packages --no-cache+ dotnet restore "$smoke/PublicPackageSmoke.csproj" --source "$pwd/local-feed" --source 'https://api.nuget.org/v3/index.json' --packages $packages --no-cachedotnet run --project "$smoke/PublicPackageSmoke.csproj" --configuration Release --no-restore --property:RestorePackagesPath=$packagespublish-public-libraries:@@ -86,7 +86,7 @@ jobs:steps:- uses: actions/download-artifact@v4with:- name: public-libraries-preview2+ name: public-libraries-preview3path: packages- name: Authenticate to NuGet with trusted publishingid: nuget-login@@ -97,13 +97,14 @@ jobs:shell: pwshrun: |Get-Content packages/PACKAGE_ORDER.txt | ForEach-Object {- $package = "packages/$_.2.0.0-preview.2.nupkg"+ $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-duplicateif ($LASTEXITCODE -ne 0) { throw "NuGet push failed for $_" }}release-build:if: startsWith(github.ref, 'refs/tags/v')+ needs: build-testruns-on: windows-latestpermissions:contents: read@@ -115,23 +116,36 @@ jobs:- uses: actions/setup-node@v4with:node-version: 26- - name: Restore and build Preview 2 frozen baseline+ - name: Install pinned TSPack+ shell: pwsh+ run: |+ $archive = Join-Path $env:RUNNER_TEMP 'tspack-windows-amd64.zip'+ $install = Join-Path $env:RUNNER_TEMP 'tspack'+ Invoke-WebRequest 'https://github.com/yuechen-li-dev/tspack/releases/download/v0.1.8/tspack-windows-amd64.zip' -OutFile $archive+ $actual = (Get-FileHash $archive -Algorithm SHA256).Hash.ToLowerInvariant()+ $expected = '7d5e58d64e6adcadbbc70eb1f283643c6bc43838847575741c55a91154bd675f'+ if ($actual -ne $expected) { throw "TSPack checksum mismatch: $actual" }+ Expand-Archive $archive -DestinationPath $install+ $executable = Get-ChildItem $install -Filter tspack.exe -Recurse | Select-Object -First 1+ if ($null -eq $executable) { throw 'TSPack executable was not found in the verified archive.' }+ $executable.DirectoryName | Out-File $env:GITHUB_PATH -Encoding utf8 -Append+ & $executable.FullName --version+ - name: Restore and build Preview 3 frozen baselinerun: |dotnet restore Aetheris.slnx- dotnet restore demos/Aetheris.PmiInjectionDemo/Aetheris.PmiInjectionDemo.csproj- dotnet build Aetheris.slnx -f net10.0 --no-restore /m:1 -c Release+ dotnet build Aetheris.slnx --no-restore /m:1 -c Release- name: Test frozen baseline- run: |- dotnet test Aetheris.Kernel.Core.Tests -f net10.0 -c Release --no-build --filter "Category!=SlowCorpus"- 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+ run: dotnet test Aetheris.slnx -c Release --no-build -m:1 -- RunConfiguration.MaxCpuCount=1- name: Package exact release bytesshell: pwsh- run: ./scripts/package-release.ps1 -Version ($env:GITHUB_REF_NAME.TrimStart('v')) -OutputDirectory artifacts/release/published+ run: |+ $version = $env:GITHUB_REF_NAME.TrimStart('v')+ ./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: preview2-release+ name: preview3-releasepath: artifacts/release/publishedif-no-files-found: error@@ -142,7 +156,7 @@ jobs:- uses: actions/checkout@v4- uses: actions/download-artifact@v4with:- name: preview2-release+ name: preview3-releasepath: release- name: Clean-directory CLI and package smokeshell: pwsh@@ -165,9 +179,23 @@ jobs:$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.2 --add-source local-feed --ignore-failed-sources+ dotnet tool install --tool-path installed-tool Aetheris.CLI --version 2.0.0-preview.3 --add-source local-feed --ignore-failed-sources& installed-tool/aetheris --version& installed-tool/aetheris build smoke.firmament+ - name: Verify checksums and public packages+ shell: pwsh+ run: |+ foreach ($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'+ Copy-Item tests/PublicPackageSmoke $smoke -Recurse+ dotnet restore "$smoke/PublicPackageSmoke.csproj" --source "$pwd/release/packages/public-libraries" --source 'https://api.nuget.org/v3/index.json' --packages $packages --no-cache+ dotnet run --project "$smoke/PublicPackageSmoke.csproj" --configuration Release --no-restore --property:RestorePackagesPath=$packagespublish:needs: release-smoke@@ -180,19 +208,27 @@ jobs:- uses: actions/checkout@v4- uses: actions/download-artifact@v4with:- name: preview2-release+ name: preview3-releasepath: release- name: Authenticate to NuGet with trusted publishingid: nuget-loginuses: NuGet/login@v1with:user: yuechen-li- - 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+ - name: Publish the tested NuGet packages+ shell: pwsh+ run: |+ 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"+ 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 $_" }+ }+ - name: Create release and upload the tested assetsenv:GH_TOKEN: ${{ github.token }}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.2-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- gh release edit "${GITHUB_REF_NAME}" --repo "${GITHUB_REPOSITORY}" --latest --prerelease=false --notes-file docs/release/2.0.0-preview.2-notes.md+ 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.mddiff --git a/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.cs b/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.csindex 748d8825..f0a2c94e 100644--- a/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.cs+++ b/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.cs@@ -55,6 +55,8 @@ public sealed class BrepSurgeryRecipeParityTestsvar export = Step242Exporter.ExportBody(body);Assert.True(export.IsSuccess, string.Join(Environment.NewLine, export.Diagnostics.Select(diagnostic => diagnostic.Message)));+ Assert.EndsWith("\r\n", export.Value, StringComparison.Ordinal);+ Assert.DoesNotContain("\n", export.Value.Replace("\r\n", string.Empty, StringComparison.Ordinal), StringComparison.Ordinal);Assert.Equal(expectedStepSha256, Sha256(export.Value));var reimport = Step242Importer.ImportBody(export.Value);diff --git a/Aetheris.Kernel.Core.Tests/Step242/Step242AssemblyProductStructureTests.cs b/Aetheris.Kernel.Core.Tests/Step242/Step242AssemblyProductStructureTests.csindex cccf8bed..ca91159e 100644--- a/Aetheris.Kernel.Core.Tests/Step242/Step242AssemblyProductStructureTests.cs+++ b/Aetheris.Kernel.Core.Tests/Step242/Step242AssemblyProductStructureTests.cs@@ -22,6 +22,8 @@ public sealed class Step242AssemblyProductStructureTestsAssert.True(first.IsSuccess, string.Join(Environment.NewLine, first.Diagnostics.Select(diagnostic => diagnostic.Message)));Assert.Equal(first.Value, second.Value);+ Assert.EndsWith("\r\n", first.Value, StringComparison.Ordinal);+ Assert.DoesNotContain("\n", first.Value.Replace("\r\n", string.Empty, StringComparison.Ordinal), StringComparison.Ordinal);Assert.Equal(1, Count(first.Value, "MANIFOLD_SOLID_BREP("));Assert.Equal(2, Count(first.Value, "NEXT_ASSEMBLY_USAGE_OCCURRENCE("));diff --git a/Aetheris.Kernel.Core/Step242/Step242AssemblyProductStructure.cs b/Aetheris.Kernel.Core/Step242/Step242AssemblyProductStructure.csindex 2bed7e5a..67e6784a 100644--- a/Aetheris.Kernel.Core/Step242/Step242AssemblyProductStructure.cs+++ b/Aetheris.Kernel.Core/Step242/Step242AssemblyProductStructure.cs@@ -149,16 +149,16 @@ public static class Step242AssemblyExporter}var builder = new StringBuilder();- builder.AppendLine("ISO-10303-21;");- builder.AppendLine("HEADER;");- builder.AppendLine("FILE_DESCRIPTION(('Aetheris AP242 assembly product structure'),'2;1');");- builder.AppendLine("FILE_NAME('aetheris_assembly.step','1970-01-01T00:00:00',('Aetheris'),('Aetheris'),'Aetheris.Kernel','Aetheris.Kernel','');");- builder.AppendLine("FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));");- builder.AppendLine("ENDSEC;");- builder.AppendLine("DATA;");- foreach (var entity in entities) builder.AppendLine(entity);- builder.AppendLine("ENDSEC;");- builder.AppendLine("END-ISO-10303-21;");+ Step242TextWriter.AppendCanonicalLine(builder, "ISO-10303-21;");+ Step242TextWriter.AppendCanonicalLine(builder, "HEADER;");+ Step242TextWriter.AppendCanonicalLine(builder, "FILE_DESCRIPTION(('Aetheris AP242 assembly product structure'),'2;1');");+ Step242TextWriter.AppendCanonicalLine(builder, "FILE_NAME('aetheris_assembly.step','1970-01-01T00:00:00',('Aetheris'),('Aetheris'),'Aetheris.Kernel','Aetheris.Kernel','');");+ Step242TextWriter.AppendCanonicalLine(builder, "FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));");+ Step242TextWriter.AppendCanonicalLine(builder, "ENDSEC;");+ Step242TextWriter.AppendCanonicalLine(builder, "DATA;");+ foreach (var entity in entities) Step242TextWriter.AppendCanonicalLine(builder, entity);+ Step242TextWriter.AppendCanonicalLine(builder, "ENDSEC;");+ Step242TextWriter.AppendCanonicalLine(builder, "END-ISO-10303-21;");return KernelResult<string>.Success(builder.ToString());}diff --git a/Aetheris.Kernel.Core/Step242/Step242TextWriter.cs b/Aetheris.Kernel.Core/Step242/Step242TextWriter.csindex c8ec7527..2baa0c40 100644--- a/Aetheris.Kernel.Core/Step242/Step242TextWriter.cs+++ b/Aetheris.Kernel.Core/Step242/Step242TextWriter.cs@@ -24,24 +24,27 @@ internal sealed class Step242TextWriterpublic string Build(Step242HeaderMetadata headerMetadata){var sb = new StringBuilder();- sb.AppendLine("ISO-10303-21;");- sb.AppendLine("HEADER;");- sb.AppendLine($"FILE_DESCRIPTION(('{EscapeString(headerMetadata.Description)}'),'2;1');");- sb.AppendLine($"FILE_NAME('{EscapeString(headerMetadata.FileName)}','{EscapeString(headerMetadata.CreationTimestamp)}',('{EscapeString(headerMetadata.Author)}'),('{EscapeString(headerMetadata.Organization)}'),'{EscapeString(headerMetadata.PreprocessorVersion)}','{EscapeString(headerMetadata.OriginatingSystem)}','{EscapeString(headerMetadata.Authorization)}');");- sb.AppendLine("FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));");- sb.AppendLine("ENDSEC;");- sb.AppendLine("DATA;");+ AppendCanonicalLine(sb, "ISO-10303-21;");+ AppendCanonicalLine(sb, "HEADER;");+ AppendCanonicalLine(sb, $"FILE_DESCRIPTION(('{EscapeString(headerMetadata.Description)}'),'2;1');");+ AppendCanonicalLine(sb, $"FILE_NAME('{EscapeString(headerMetadata.FileName)}','{EscapeString(headerMetadata.CreationTimestamp)}',('{EscapeString(headerMetadata.Author)}'),('{EscapeString(headerMetadata.Organization)}'),'{EscapeString(headerMetadata.PreprocessorVersion)}','{EscapeString(headerMetadata.OriginatingSystem)}','{EscapeString(headerMetadata.Authorization)}');");+ AppendCanonicalLine(sb, "FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));");+ AppendCanonicalLine(sb, "ENDSEC;");+ AppendCanonicalLine(sb, "DATA;");foreach (var entity in _entities){- sb.AppendLine(entity);+ AppendCanonicalLine(sb, entity);}- sb.AppendLine("ENDSEC;");- sb.AppendLine("END-ISO-10303-21;");+ AppendCanonicalLine(sb, "ENDSEC;");+ AppendCanonicalLine(sb, "END-ISO-10303-21;");return sb.ToString();}+ internal static StringBuilder AppendCanonicalLine(StringBuilder builder, string value)+ => builder.Append(value).Append("\r\n");+public static string Ref(string entityId) => entityId;public static string String(string value) => $"'{EscapeString(value)}'";diff --git a/docs/release/2.0.0-preview.3-notes.md b/docs/release/2.0.0-preview.3-notes.mdnew file mode 100644index 00000000..63cd64d4--- /dev/null+++ b/docs/release/2.0.0-preview.3-notes.md@@ -0,0 +1,31 @@+# Aetheris 2.0.0-preview.3++Aetheris Preview 3 is the feature-frozen Windows x64 release of a semantic,+compiler-style CAD system. Firmament engineering intent lowers through bounded+geometry, manufacturing, and analysis workflows to STEP AP242 and related artifacts,+with Cadmata for interactive 3D inspection and Forge Host Protocol v1 for+language-neutral Template invocation.++Highlights:++- Firmament V2 Records, Templates, static engineering data, and explicit diagnostics+- bounded analytic/prismatic modeling with Boss, finite Pocket, semantic holes, and EdgeFinish+- STEP AP242 import/export and semantic PMI+- formed/flat Sheet Metal with material, DFM, STEP, and SVG outputs+- Standard Library materials and bounded linear-elastic FEA+- Cadmata production UI and NativeAOT Forge Host with Python, Go, Rust, and TypeScript clients++Download the Windows ZIP for the complete product. The standalone CLI tool, 16 public+libraries, and VS Code extension are also attached. Preview 3 release binaries are+qualified only for `win-x64`; geometry, imported STEP, Sheet Metal, PMI, and FEA+boundaries are documented in the+[known issues](https://github.com/yuechen-li-dev/Aetheris/blob/v2.0.0-preview.3/docs/public/reference/known-issues.md)+and+[support matrix](https://github.com/yuechen-li-dev/Aetheris/blob/v2.0.0-preview.3/docs/public/reference/supported-features.md).++Start with+[Getting Started](https://github.com/yuechen-li-dev/Aetheris/blob/v2.0.0-preview.3/docs/public/getting-started.md)+and verify downloads with the attached `SHA256SUMS.txt`.++Aetheris code is available under GNU AGPL-3.0. Alternative licensing is available on+request. Third-party assets retain their respective licenses and provenance.diff --git a/docs/release/PREVIEW3-CLAIMS.md b/docs/release/PREVIEW3-CLAIMS.mdindex 006f84de..721004ae 100644--- a/docs/release/PREVIEW3-CLAIMS.md+++ b/docs/release/PREVIEW3-CLAIMS.md@@ -14,7 +14,7 @@ This is verification scaffolding, not launch or Hacker News prose. Counts and ha| Serial .NET tests | 3,017 passed; 0 failed; 0 skipped | final A5 validation report || CTC-03 manufacturing PMI | 3 datums, 13 dimensions, 5 position controls, 8 annotations, 23 associated items | [`PREVIEW3-HARDEN-A4.md`](PREVIEW3-HARDEN-A4.md), final PMI smoke || A36 cantilever sanity witness | ~25.06 µm Aetheris vs ~24.7 µm simple beam theory | [`fea.md`](../public/firmament/fea.md), final FEA smoke |-| Release integrity | deterministic archive normalization retained; 19 staged binary hashes recomputed and verified | `scripts/package-release.ps1`, `scripts/finalize-publication.ps1`, final A5 report |+| Release integrity | deterministic archive normalization retained; the tag workflow generates and verifies all 19 binary hashes before publication | `scripts/package-release.ps1`, `scripts/finalize-publication.ps1`, release workflow || Feature freeze | no new product capability in A5 | final A5 diff audit/report |Do not convert this sheet into an HN title, post, comment plan, or marketing claim.diff --git a/docs/release/PREVIEW3-HARDEN-A5.md b/docs/release/PREVIEW3-HARDEN-A5.mdindex 17a6c775..45b2142c 100644--- a/docs/release/PREVIEW3-HARDEN-A5.md+++ b/docs/release/PREVIEW3-HARDEN-A5.md@@ -2,9 +2,15 @@## Publication verdict-Yes. Aetheris `2.0.0-preview.3` is ready for the project owner to commit, tag as-`v2.0.0-preview.3`, and publish using the exact staged bytes recorded below. No tag,-push, package publication, or remote release was performed by A5.+Yes. Aetheris `2.0.0-preview.3` completed the A5 publication gate. No tag, push,+package publication, or remote release was performed by A5.++After A5, the first Ubuntu push check exposed platform-dependent STEP line endings in+three byte-hash assertions. The publication follow-up made AP242 text explicitly CRLF+on every platform while preserving the qualified Windows bytes. Because that code+correction changes binary payloads, the A5 candidate hashes were superseded. The tag+workflow now generates `SHA256SUMS.txt` and `RELEASE-INVENTORY.md` from the tagged+commit and verifies them before any publication job can run.The final bounded smoke passed from a clean extraction of the Windows ZIP in a pathcontaining spaces. ReleaseBlocker and MustFix count: zero. The remaining boundaries@@ -12,32 +18,12 @@ are the documented Preview 3 limitations.## Final artifacts-The canonical generated files are-`artifacts/release/a5-final/SHA256SUMS.txt` and-`artifacts/release/a5-final/RELEASE-INVENTORY.md`. All 19 checksum entries were-recomputed from disk and verified after final staging.--| Staged artifact | Bytes | SHA-256 |-| --- | ---: | --- |-| `Aetheris-2.0.0-preview.3-win-x64.zip` | 107,779,368 | `2e6a8efabd83363a6e5af4be12f2d113cc626f2cd6d90902abb99bcc4fdb89b8` |-| `aetheris-firmament-0.3.0-preview.3.vsix` | 11,937 | `def44bc6a83aed90a67505987ec36d00aa134d900fab734c48b83d0aeb59f361` |-| `packages/Aetheris.CLI.2.0.0-preview.3.nupkg` | 33,411,117 | `abe221bdb24e31b1cedd32b5b08fb3d220754f6254abd13a193758d3b5ebb07e` |-| `packages/public-libraries/Aetheris.Collaboration.2.0.0-preview.3.nupkg` | 17,633 | `8af8cdf29798d4ccbf83cae928b67bbf6c5de4ced97f55aa69f8f6203265fe6b` |-| `packages/public-libraries/Aetheris.Continuum.2.0.0-preview.3.nupkg` | 254,726 | `97448b0a88880c0271832375ee78ebc331bd497b90d0da24a2a6e7eae2a3d0d4` |-| `packages/public-libraries/Aetheris.FEA.2.0.0-preview.3.nupkg` | 110,851 | `e31484dccc5af838ff573e4b1809f6b1fc20e8a53a1e9cfb42d0b5e067324139` |-| `packages/public-libraries/Aetheris.Forge.2.0.0-preview.3.nupkg` | 60,458 | `964cb6d4543240a9fdd0ef34c4a747ec3666142644be1fefd789f49483861e66` |-| `packages/public-libraries/Aetheris.Forge.Host.2.0.0-preview.3.nupkg` | 78,114 | `95b91c3512744cf8762b33a7ef818f7dd9ca73df454e84d314411ee6696616cf` |-| `packages/public-libraries/Aetheris.Forge.KernelSDK.2.0.0-preview.3.nupkg` | 4,859 | `acc1eec08bd0097ffe0508d87cb1027488986c3453e02013ed8b7c4e338ca6b7` |-| `packages/public-libraries/Aetheris.Geometry.2.0.0-preview.3.nupkg` | 87,063 | `58a3bcb155a1864694ba7612520e08910612d5d7f790a75b1622b5bd7fd1bb7f` |-| `packages/public-libraries/Aetheris.Kernel.Core.2.0.0-preview.3.nupkg` | 866,015 | `110dbc667abb005270dfd486fd1f5e09ba551d374ddad7b0d7659c35a438e9ca` |-| `packages/public-libraries/Aetheris.Kernel.Firmament.2.0.0-preview.3.nupkg` | 1,493,720 | `ef7c5366f21b07e60a1b3482beada2237c1bb6f89846852600b3512cd57674d1` |-| `packages/public-libraries/Aetheris.Kernel.StandardLibrary.2.0.0-preview.3.nupkg` | 88,369 | `29a17260d9bb56b2bf79c8bbe3ae7b46efec533380da2f1ebc564cb954bcd93e` |-| `packages/public-libraries/Aetheris.Modules.2.0.0-preview.3.nupkg` | 17,185 | `a8e9b4d3a180ca0a50053952da13fc36d7a0a8c6e999c666fd481df8497e09bd` |-| `packages/public-libraries/Aetheris.Modules.BuiltIn.2.0.0-preview.3.nupkg` | 6,526 | `3e7a33aa17e5c95cebaefec5362066b8082f953eacfba7f2712f598244b9f542` |-| `packages/public-libraries/Aetheris.Piping.2.0.0-preview.3.nupkg` | 20,517 | `69cfa0e1a721e8f8534f9c52b0fd6ad6e68ce1439cd61050aa510055ee28c87f` |-| `packages/public-libraries/Aetheris.Semantics.2.0.0-preview.3.nupkg` | 30,509 | `f2360d2e86e9d8dfce0904c1d947e37761c50f1dd5c236c116fbbd9d8f703187` |-| `packages/public-libraries/Aetheris.SheetMetal.2.0.0-preview.3.nupkg` | 304,744 | `dc5579fe7128d6baed813a4b5b1dc8915009b1c6ee929f6e688082506fa52e08` |-| `packages/public-libraries/Aetheris.Surfacing.2.0.0-preview.3.nupkg` | 64,539 | `440fad9d7b4d27a76ae2338042206ea649c9a6a5ca468a518c006765ae16209f` |+The tagged workflow stages 19 release-distributed binaries: the Windows x64 ZIP,+Firmament VSIX, CLI package, and 16 public libraries. It generates the canonical+`SHA256SUMS.txt` and `RELEASE-INVENTORY.md` from those exact bytes, verifies every+entry in a separate release-smoke job, then publishes the same downloaded workflow+artifact. Checked-in documentation intentionally does not duplicate mutable binary+hashes.The ZIP contains the self-contained CLI and Cadmata host, the NativeAOT Forge Host,material catalog, public docs, licenses, tracked examples, and four foreign-languagediff --git a/docs/release/PREVIEW3-RELEASE-STAGING.md b/docs/release/PREVIEW3-RELEASE-STAGING.mdindex 50e7b397..e835517f 100644--- a/docs/release/PREVIEW3-RELEASE-STAGING.md+++ b/docs/release/PREVIEW3-RELEASE-STAGING.md@@ -52,9 +52,8 @@ Aetheris code is available under GNU AGPL-3.0; alternative licensing is availabl## Owner release checklist-1. Confirm the A5 report verdict, clean commit, and no post-validation changes.-2. Compare upload bytes to `RELEASE-INVENTORY.md` and `SHA256SUMS.txt`.-3. Create and push annotated tag `v2.0.0-preview.3`.-4. Create the GitHub release from that tag and upload the exact qualified artifacts.-5. Paste/adapt the factual body above; do not infer support beyond the linked matrix.-6. Verify the published asset hashes once after upload.+1. Confirm the A5 report verdict, green `master` push check, clean commit, and no post-validation changes.+2. Create and push annotated tag `v2.0.0-preview.3`.+3. Allow the protected production environment to publish only after `build-test`, `release-build`, and `release-smoke` pass.+4. Compare the published assets to the workflow-generated `RELEASE-INVENTORY.md` and `SHA256SUMS.txt`.+5. Verify the published asset hashes once after upload; do not infer support beyond the linked matrix.diff --git a/docs/release/preview3-release-manifest.json b/docs/release/preview3-release-manifest.jsonindex 15ee2906..df220e3b 100644--- a/docs/release/preview3-release-manifest.json+++ b/docs/release/preview3-release-manifest.json@@ -45,11 +45,9 @@"representativeHashes": {"stepAp242": "114cd7c0c6a8a364b2943cc955a12d8a96b576a187dfc1957ea9f769296872be","flatStep": "88c437373fe4fdf91e8f0a5b5e0e5c135b290f0dfe18449ec3ee7c0970c1d075",- "svg": "1657e3bbc3ef418617b45c5d9ab76a96d70b0ba6356c0e88a7ba07edc18b6519",- "windowsBundle": "2e6a8efabd83363a6e5af4be12f2d113cc626f2cd6d90902abb99bcc4fdb89b8",- "firmamentVsix": "def44bc6a83aed90a67505987ec36d00aa134d900fab734c48b83d0aeb59f361",- "cliNuget": "abe221bdb24e31b1cedd32b5b08fb3d220754f6254abd13a193758d3b5ebb07e"+ "svg": "1657e3bbc3ef418617b45c5d9ab76a96d70b0ba6356c0e88a7ba07edc18b6519"},+ "releaseArtifactHashes": "Generated from the tagged commit into SHA256SUMS.txt and verified by release-smoke before publication.","knownPackagingLimitations": ["Only win-x64 is qualified for Preview 3.","The CLI and Cadmata are self-contained JIT applications; Forge Host is the qualified NativeAOT executable.",diff --git a/scripts/finalize-publication.ps1 b/scripts/finalize-publication.ps1index 6f8ad354..8f93dd4b 100644--- a/scripts/finalize-publication.ps1+++ b/scripts/finalize-publication.ps1@@ -23,6 +23,12 @@ foreach ($package in $publicPackages) {Copy-Item -LiteralPath $package.FullName -Destination (Join-Path $publicPackageDestination $package.Name) -Force}+$packageOrder = Join-Path $publicLibrariesRoot "PACKAGE_ORDER.txt"+if (-not (Test-Path -LiteralPath $packageOrder -PathType Leaf)) {+ throw "Public library package order is missing: $packageOrder"+}+Copy-Item -LiteralPath $packageOrder -Destination (Join-Path $publicPackageDestination "PACKAGE_ORDER.txt") -Force+$binaryArtifacts = @(Get-ChildItem -LiteralPath $releaseRoot -File -Recurse |Where-Object { $_.Extension -in @(".zip", ".vsix", ".nupkg") } |