Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Align release entry points with 2.0.0 admission and package qualification
Yuechen Lidee3c69c6e47
diff --git a/README.md b/README.mdindex 23371402..4e279404 100644--- a/README.md+++ b/README.md@@ -43,13 +43,13 @@ Dangerous operations which may generate degenerate/sliver/zero-dimension geometr## Try it-The easiest complete experience is the `Aetheris-2.0.0-preview.3-win-x64.zip` release bundle. It includes the CLI, Cadmata, NativeAOT Forge Host, public documentation, examples, and material catalog. The standalone .NET tool provides the CLI but not Cadmata:+The complete Windows experience is the `Aetheris-2.0.0-win-x64.zip` release bundle. It includes the CLI, Cadmata, NativeAOT Forge Host, public documentation, examples, and material catalog. The standalone managed .NET tool provides the CLI on Windows and Linux x64:```powershell-dotnet tool install --global Aetheris.CLI --version 2.0.0-preview.3+dotnet tool install --global Aetheris.CLI --version 2.0.0aetheris --version-aetheris build fixtures/Canonical/PMI/hole-diameter-and-datum.firmament --output out/first-part.step --json-aetheris analyze out/first-part.step --json+aetheris build fixtures/Canonical/PMI/hole-diameter-and-datum.firmament --output artifacts/local/first-part.step --json+aetheris analyze artifacts/local/first-part.step --json```Go next to [Getting Started](docs/public/getting-started.md), then [Learn Firmament](docs/public/learn/README.md): six short lessons from a first part to an assembly. The [documentation index](docs/public/README.md) has everything else, and the [project history](docs/development/history/README.md) tells how Aetheris got here.@@ -65,25 +65,25 @@ See [cantilever](fixtures/Canonical/FEA/material-resolved-cantilever.firmament)*A qualified flat-pattern sheet metal artifact, created entirely by GPT 5.6 Sol with human guidance, including formed STEP, flat STEP, SVG, bend identity, material identity, and DFM evidence on the documented Sheet Metal routes.*```powershell-$host = ".\forge-host\Aetheris.Forge.Host.exe"-& $host list-& $host describe Standard.SheetMetal.ElectronicsEnclosure-python .\samples\forge-interop-x1\python\client.py $host .\samples\forge-interop-x1\request.json .\out\forge-python+$forgeHost = ".\forge-host\Aetheris.Forge.Host.exe"+& $forgeHost list+& $forgeHost describe Standard.SheetMetal.ElectronicsEnclosure+python .\samples\forge-interop-x1\python\client.py $forgeHost .\samples\forge-interop-x1\request.json .\out\forge-python```-The bundle contains equivalent [Go, Rust, and TypeScript clients](samples/forge-interop-x1/README.md). Forge Host Protocol v1 is independently versioned from Aetheris `2.0.0-preview.3`.+The bundle contains equivalent [Go, Rust, and TypeScript clients](samples/forge-interop-x1/README.md). Forge Host Protocol v1 is independently versioned from Aetheris `2.0.0`.## Installation surfaces-| Surface | Use | Preview 3 status |+| Surface | Use | 2.0.0 status ||---|---|---|| Windows release ZIP | Complete CLI + Cadmata + Forge.Host experience | Qualified on `win-x64` || `Aetheris.CLI` .NET tool | Firmament, STEP, Sheet Metal, and FEA commands | Published package; Cadmata not included |-| Public NuGet libraries | Direct .NET integration | 16 version-aligned packages |+| Public NuGet libraries | Direct .NET integration | 25 dependency-closed, version-aligned packages || Forge.Host | Language-neutral Template invocation | NativeAOT `win-x64`, Protocol v1 || VS Code extension | Firmament syntax and CLI-backed commands | Independently versioned `0.3.0-preview.3` VSIX |-Linux and macOS release binaries are **not** qualified in Preview 3. Framework-level portability tests do not expand the release-binary promise.+The managed CLI is qualified on Windows x64 and Linux x64. The self-contained desktop ZIP targets Windows x64; macOS is not a qualified release target. See the [release notes](docs/release/2.0.0-notes.md) for capability and experimental API boundaries.## License and acknowledgmentsdiff --git a/docs/development/reports/2026-10/RELEASE-2.0.0-CLOSEOUT.md b/docs/development/reports/2026-10/RELEASE-2.0.0-CLOSEOUT.mdindex eb086275..f1c25fa8 100644--- a/docs/development/reports/2026-10/RELEASE-2.0.0-CLOSEOUT.md+++ b/docs/development/reports/2026-10/RELEASE-2.0.0-CLOSEOUT.md@@ -109,13 +109,16 @@ with the new stable name retained. Five regression cases select that previouslyunused Plate recipe and confirm each inserted field rejects validate and build.These are explicit classifications, not a blanket exemption for Template bodies.-The public-byte build passed 5,998 tests after those final eleven closures.-The resulting source also passes sixty focused CLI/edge-finish cases. Final-hosted release qualification remains a gate. Both completed-380-file comparisons so far retained identical exits and byte-identical STEP+The final public-byte build passed 6,003 tests across twenty suites, with zero+failures and zero skips; the optional external PDF renderer was enabled. The+fast kernel lane passed 1,088 tests. Sixty focused CLI/edge-finish cases also+pass. Final hosted release qualification remains a gate. All completed+380-file comparisons retained identical exits and byte-identical STEPfor all 297 successful engineering builds. The remaining 83 files compriselibrary/inspection sources, garment sources needing body input, and non-STEPproducts; they are not relabeled as geometry regressions.+After the CRLF repair, all twenty-three CRLF corpus specimens were replayed+against the original baseline: identical command outcomes and STEP bytes.The real product-path rehearsal also generated a production PDF/SVG/PPTX drawing,a warehouse GLB and cantilever analysis artifacts. Raw evidence is retaineddiff --git a/docs/public/README.md b/docs/public/README.mdindex ff543442..5dc9a78c 100644--- a/docs/public/README.md+++ b/docs/public/README.md@@ -107,7 +107,7 @@ cannot honour.- [Targets and selectors](reference/targets.md)- [Supported features](reference/supported-features.md) and [known issues](reference/known-issues.md)- [Wireframe SVG previews](reference/wireframe.md)-- Release notes: [Preview 3](reference/release-notes.md), [Preview 4 Cadmata](cadmata/preview4-release-notes.md)+- Release notes: [2.0.0](reference/release-notes.md), [historical Preview 4 Cadmata](cadmata/preview4-release-notes.md)## Showcasesdiff --git a/docs/public/getting-started.md b/docs/public/getting-started.mdindex 99f04caa..613f85d4 100644--- a/docs/public/getting-started.md+++ b/docs/public/getting-started.md@@ -1,9 +1,9 @@# Getting Started-Preview 3 is qualified for Windows x64. Install the published .NET global tool with the .NET 10 SDK, or run the CLI from a source checkout:+Aetheris 2.0.0 qualifies the managed CLI on Windows x64 and Linux x64. Install the .NET global tool with the .NET 10 SDK, or run the CLI from a source checkout:```powershell-dotnet tool install --global Aetheris.CLI --prerelease+dotnet tool install --global Aetheris.CLI --version 2.0.0aetheris --help```@@ -15,11 +15,11 @@ The qualified first part is [`hole-diameter-and-datum.firmament`](../../fixtures```powershellaetheris validate fixtures/Canonical/PMI/hole-diameter-and-datum.firmament --json-aetheris build fixtures/Canonical/PMI/hole-diameter-and-datum.firmament --output artifacts/first-part.step --json-aetheris analyze artifacts/first-part.step --json+aetheris build fixtures/Canonical/PMI/hole-diameter-and-datum.firmament --output artifacts/local/first-part.step --json+aetheris analyze artifacts/local/first-part.step --json```-`validate` checks syntax, binding, units, targets, and supported/deferred PMI without materializing geometry. A successful validation exits zero and reports `firmamentV2Validation.status: "valid"`. `build` runs the real geometry and AP242 path; its JSON includes `success`, output path, diagnostics, feature reports, and `pmiExportEvidence` describing what was actually emitted. `analyze` independently reinspects topology and semantic PMI.+Normal `validate` checks syntax, binding, units, targets and capability admission, including the engineering preflight required by the domain. It can construct geometry in memory; it does not write a build artifact. A successful validation exits zero and reports `firmamentV2Validation.status: "valid"` with its validation level. `--parse-only` is a limited check and does not prove build admission. `build` writes the real geometry and AP242 artifact; its JSON includes `success`, output path, diagnostics, feature reports, and `pmiExportEvidence` describing what was actually emitted. `analyze` independently reinspects topology and semantic PMI.Use `aetheris view ...` to open Firmament or STEP in Cadmata when using the Windows bundle.diff --git a/docs/public/reference/known-issues.md b/docs/public/reference/known-issues.mdindex dd18a844..eaa3b829 100644--- a/docs/public/reference/known-issues.md+++ b/docs/public/reference/known-issues.md@@ -1,10 +1,11 @@-# Preview 3 known issues and limitations+# Aetheris 2.0.0 known issues and limitations-- Release binaries are qualified for Windows x64 only. Framework tests on other platforms are not a binary-support promise.+- The managed CLI is qualified on Windows x64 and Linux x64. The self-contained desktop ZIP targets Windows x64; macOS is not qualified.- `inlineSTEP` FEA supports the documented single-body imported class and stable imported face identities. Arbitrary imported containment and multi-root assembly-like STEP are rejected explicitly; some OCCT B-spline containment cases remain outside the qualified class.- The generic tessellated mass verifier can report `Unavailable` for some valid combined analytic Boss/Pocket/hole models when a face cannot be triangulated. STEP reimport, manifold checks, analytic surface inventory, bounds, and route-specific analytic volume remain available; do not interpret an unavailable tessellation estimate as a topology failure.-- The published Preview 3 binary predates composed-profile Countersink. Current source admits bounded +Z through counterbore/countersink entries with complete disjoint footprints and positive shaft length. Oriented Compose hole adapters, entry breakouts and chamfer corridors crossing a cavity transition remain explicitly rejected. Sheet Metal Counterbore and Countersink are rejected because those formed-opening semantics are not implemented.+- Composed profiles admit bounded +Z through counterbore/countersink entries with complete disjoint footprints and positive shaft length. Oriented Compose hole adapters, entry breakouts and chamfer corridors crossing a cavity transition remain explicitly rejected. Sheet Metal Counterbore and Countersink are rejected because those formed-opening semantics are not implemented.- Composed-body fillets require a cavity-preserving adapter over the existing body. The standalone Profile fillet planner constructs a new extrusion; the compiler rejects applying it to Compose rather than losing existing material features. Disjoint composed perimeter chamfers are supported within their station/corridor limits.-- Imported STEP analysis currently reports millimetres as the qualified public length unit but does not preserve the source unit entity in imported topology metadata. Use millimetre AP242 input for Preview 3 workflows.+- STEP import normalizes recognized declared length units to millimetres, and the parsed document retains the conversion factor. Public engineering measurements use millimetres; imported topology does not preserve the original unit entity as an editable semantic object.- Standard Library material resolution is qualified for Firmament FEA and authored Sheet Metal. Ordinary prismatic CAD STEP export does not yet persist a general solid-material designation; do not infer one from the geometry artifact.- Cadmata may emit one Three.js `Clock` deprecation warning in the browser developer console. It does not affect loading, navigation, selection, PMI interaction, or model switching.+- Normal validation includes domain-specific engineering preflight. Swept and spline-heavy models can take seconds; parse-only validation is explicitly limited. Expansion source maps are incomplete, so some diagnostics disclose enclosing locations rather than an exact authored token.