Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Document Preview 1 release evidence

Yuechen Li5fcac5980c0f
diff --git a/README.md b/README.md
index c91e7ebc..e2f558ed 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,21 @@
Firmament is a deterministic DSL for generating CAD geometry (STEP AP242) via Aetheris.
+## Preview 1 release
+
+Aetheris 2.0.0-preview.1 is available as a complete Windows x64 bundle and as
+the `Aetheris.CLI` .NET global tool. Download the bundle (including Cadmata)
+from the [GitHub Release](https://github.com/yuechen-li-dev/Aetheris/releases/tag/v2.0.0-preview.1),
+or install the CLI with:
+
+```bash
+dotnet tool install --global Aetheris.CLI --prerelease
+```
+
+The NuGet tool does not include Cadmata; use the Windows bundle for `aetheris view`.
+The public manual, installation guidance, support boundary, and Preview 1
+limitations are at [yuechen-li-dev.github.io/aetheris](https://yuechen-li-dev.github.io/aetheris/).
+
## What works today
- primitives and booleans: `box`, `cylinder`, `sphere`, `add`, `subtract`, `intersect`
diff --git a/docs/release/2.0.0-preview.1-release.md b/docs/release/2.0.0-preview.1-release.md
new file mode 100644
index 00000000..08715ba3
--- /dev/null
+++ b/docs/release/2.0.0-preview.1-release.md
@@ -0,0 +1,105 @@
+# Aetheris 2.0.0-preview.1 release evidence
+
+- Release commit: `0928513ce232b6297438b938c39563009d61b457`
+- Tag: `v2.0.0-preview.1` (annotated tag object `9166b13`)
+- Release timestamp: 2026-08-08T09:12:19Z
+- GitHub Release: <https://github.com/yuechen-li-dev/Aetheris/releases/tag/v2.0.0-preview.1>
+- Release workflow: <https://github.com/yuechen-li-dev/Aetheris/actions/runs/31249836942>
+
+## Distribution decision
+
+`Aetheris.CLI` is the only Preview 1 NuGet package. It is a .NET 10 global
+tool for validation, STEP build, inspection, analysis, and verification.
+Cadmata is intentionally internal to the Windows bundle: the complete
+download-and-run viewer route is the GitHub ZIP, and the NuGet tool documents
+that `view` requires that bundle. Kernel, Firmament, Forge, server, and
+Cadmata assemblies are implementation assemblies for this preview rather than
+an established supported SDK surface, so they are `InternalOnly`/`Defer`.
+
+## Package metadata and trusted publishing
+
+`Aetheris.CLI` version `2.0.0-preview.1` has a tool command of `aetheris`, an
+AGPL-3.0-only license expression, repository and project URLs, concise tags,
+release notes, and a packaged README. NuGet trusted publishing used
+GitHub Actions OIDC through `.github/workflows/dotnet.yml`, matching the
+configured publisher (`yuechen-li-dev/Aetheris`, workflow `dotnet.yml`,
+environment `production`, package owner `yuechen-li`). The publish job had
+only `contents: write` and `id-token: write` permissions and used the
+`production` environment.
+
+## Published artifacts
+
+| Artifact | Bytes | SHA-256 |
+| --- | ---: | --- |
+| `Aetheris-2.0.0-preview.1-win-x64.zip` | 93,298,373 | `02a8cf0f65373bf4f9bcbaa1d8e1a819a354157202cd2408f8943c1b06aeb4fa` |
+| `aetheris-firmament-0.1.0-preview.1.vsix` | 12,104 | `f9dda176f50eee767142a51c12f6d5f16fee5a798000f5a4fa15a9f202445f90` |
+| `Aetheris.CLI.2.0.0-preview.1.nupkg` | 3,024,297 | `fe13b9534ae687a333957845e9323ddd4f18e624df3e04a247917bb5b717003f` |
+| `SHA256SUMS.txt` | 322 | `d5a6cd36ccb463d4c88144bcad80fb6781f1125fc5919e0246cab4f129d46f25` |
+
+The GitHub Release is a prerelease and attaches all four files above.
+
+## Build, test, and smoke evidence
+
+The exact-artifact workflow restored, built, tested, packaged, and smoke-tested
+once before promoting its workflow artifact. It completed successfully:
+
+- Core tests: 994 passed
+- Firmament tests: 1,028 passed
+- CLI tests: 348 passed
+- Server tests: 45 passed
+- Frontend tests: 58 passed; Vite production build passed
+
+Local package smoke installed `Aetheris.CLI` from a temporary local feed and
+ran `aetheris --version`, `--help`, `validate`, `build`, `inspect`, and
+`verify`. The .nupkg contains the expected tool payload, tool settings,
+metadata, and README; it contains managed PDB symbol files but no source,
+test, `.env`, or credential files.
+
+The workflow clean ZIP smoke extracted the exact uploaded artifact outside the
+repository and ran `--version`, `--help`, `validate`, `build`, `inspect`, and
+`verify`. The public GitHub download was independently downloaded again,
+verified against `SHA256SUMS.txt`, extracted fresh, and passed `--version`,
+`--help`, `validate`, `build`, `inspect`, `verify`, and STEP `analyze`.
+Cadmata's `wwwroot/index.html` and 15 production assets were present;
+`aetheris view` launched Cadmata package-relatively for both Firmament and
+STEP input.
+
+The publicly downloaded bundle also built and verified representative
+counterbore, Concept Path + Extrude, Compose L-bracket with counterbore/PMI,
+supported chamfer, bounded fillet, projected PMI, and outside-Compose Modify
+regression fixtures. The outside-Compose Modify route built its requested
+geometry rather than silently materializing a different body.
+
+NuGet.org was queried directly after publication. Its flat-container index
+listed `2.0.0-preview.1`; a fresh `dotnet tool install --tool-path ...
+--source https://api.nuget.org/v3/index.json --no-http-cache Aetheris.CLI
+--version 2.0.0-preview.1` succeeded and the installed tool passed
+`--version`, `--help`, `validate`, and `build`. The first ordinary client
+query observed normal HTTP cache propagation and was retried without cache;
+no artifact was republished or replaced.
+
+## Release notes and documentation
+
+Release notes present the Preview 1 exact-code-first CAD baseline, Firmament
+V2, AP242 output, bounded geometry features, Cadmata, and the VSIX. They also
+state the frozen limitations. Public documentation now describes both the
+Windows bundle and NuGet routes and explicitly says that NuGet does not bundle
+Cadmata. The documentation deployment completed successfully at
+<https://github.com/yuechen-li-dev/yuechen-li-dev.github.io/actions/runs/31250232028>.
+
+## Known Preview 1 limitations
+
+- Mixed whole-loop Fillet remains Experimental.
+- Concept Path-derived Profile is not accepted by Compose.
+- Foreign STEP recognition/replacement is deliberately bounded.
+- Parasolid chamfer interoperability has a known limitation.
+- Tessellated BRep volume is non-authoritative; CIR/FRep authoritative volume
+ work is deferred.
+
+## Preview 2 handoff
+
+Preview 1 is closed. The intentionally deferred next work is recorded in
+[`docs/roadmap/preview2-start.md`](../roadmap/preview2-start.md), including
+CIR/FRep volume authority, whole-loop Fillet lowering/promotion, Concept Path
+to Compose, diagnostic source spans, Cadmata MachinaLayout.js and TSPack work,
+broader foreign STEP coverage, and the Parasolid investigation.