Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Harden Preview 3 release documentation and package metadata
Yuechen Lic1e80fe76714
diff --git a/Aetheris.CLI.Tests/PublicDocumentationQualificationTests.cs b/Aetheris.CLI.Tests/PublicDocumentationQualificationTests.csindex 694737bf..2bf1b48f 100644--- a/Aetheris.CLI.Tests/PublicDocumentationQualificationTests.cs+++ b/Aetheris.CLI.Tests/PublicDocumentationQualificationTests.cs@@ -11,10 +11,19 @@ public sealed class PublicDocumentationQualificationTestspublic void PublicMarkdownRelativeLinksResolveInsideRepository(){var markdown = Directory.GetFiles(Path.Combine(RepoRoot, "docs", "public"), "*.md", SearchOption.AllDirectories)- .Append(Path.Combine(RepoRoot, "README.md"));+ .Concat(Directory.GetFiles(Path.Combine(RepoRoot, "docs", "release"), "*.md", SearchOption.TopDirectoryOnly))+ .Concat([+ Path.Combine(RepoRoot, "README.md"),+ Path.Combine(RepoRoot, "CONTRIBUTING.md"),+ Path.Combine(RepoRoot, "THIRD_PARTY_NOTICES.md"),+ Path.Combine(RepoRoot, "docs", "release", "Aetheris.CLI.README.md"),+ Path.Combine(RepoRoot, "docs", "release", "Aetheris.Libraries.README.md")+ ]);foreach (var file in markdown){- var links = Regex.Matches(File.ReadAllText(file), @"\]\((?<target>[^)]+)\)")+ var text = File.ReadAllText(file);+ Assert.DoesNotMatch(@"[A-Za-z]:\\Users\\", text);+ var links = Regex.Matches(text, @"\]\((?<target>[^)]+)\)").Select(match => match.Groups["target"].Value).Where(target => !target.StartsWith("http", StringComparison.OrdinalIgnoreCase) && !target.StartsWith('#'));foreach (var target in links)diff --git a/Aetheris.CLI/Aetheris.CLI.csproj b/Aetheris.CLI/Aetheris.CLI.csprojindex b9fcaec0..2421edae 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: release-topology hardening for Firmament V2, Forge Host, engineering modules, analysis, and drawings.</PackageReleaseNotes>+ <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><AllowedOutputExtensionsInPackageBuildOutputFolder>.dll;.exe;.json</AllowedOutputExtensionsInPackageBuildOutputFolder></PropertyGroup>diff --git a/Aetheris.Collaboration/Aetheris.Collaboration.csproj b/Aetheris.Collaboration/Aetheris.Collaboration.csprojindex 3ec09186..f82de07a 100644--- a/Aetheris.Collaboration/Aetheris.Collaboration.csproj+++ b/Aetheris.Collaboration/Aetheris.Collaboration.csproj@@ -3,6 +3,7 @@<TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>+ <Description>Semantic collaboration contracts for Aetheris engineering models and review workflows.</Description></PropertyGroup><ItemGroup><ProjectReference Include="..\Aetheris.Semantics\Aetheris.Semantics.csproj" />diff --git a/Aetheris.Continuum/Aetheris.Continuum.csproj b/Aetheris.Continuum/Aetheris.Continuum.csprojindex c1a05ede..3985f960 100644--- a/Aetheris.Continuum/Aetheris.Continuum.csproj+++ b/Aetheris.Continuum/Aetheris.Continuum.csproj@@ -3,6 +3,7 @@<TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>+ <Description>Cut-cell lattice, sparse-system, and numerical lowering infrastructure used by Aetheris analysis.</Description></PropertyGroup><ItemGroup>diff --git a/Aetheris.FEA/Aetheris.FEA.csproj b/Aetheris.FEA/Aetheris.FEA.csprojindex e6a91328..6adde57d 100644--- a/Aetheris.FEA/Aetheris.FEA.csproj+++ b/Aetheris.FEA/Aetheris.FEA.csproj@@ -3,6 +3,7 @@<TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>+ <Description>Bounded linear-elastic analysis, semantic boundary conditions, and verification artifacts for Aetheris.</Description></PropertyGroup><ItemGroup><ProjectReference Include="..\Aetheris.Continuum\Aetheris.Continuum.csproj" />diff --git a/Aetheris.Kernel.StandardLibrary/Aetheris.Kernel.StandardLibrary.csproj b/Aetheris.Kernel.StandardLibrary/Aetheris.Kernel.StandardLibrary.csprojindex 40d2cd34..db10a835 100644--- a/Aetheris.Kernel.StandardLibrary/Aetheris.Kernel.StandardLibrary.csproj+++ b/Aetheris.Kernel.StandardLibrary/Aetheris.Kernel.StandardLibrary.csproj@@ -4,6 +4,7 @@<ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable><InterceptorsNamespaces>$(InterceptorsNamespaces);Microsoft.EntityFrameworkCore.GeneratedInterceptors</InterceptorsNamespaces>+ <Description>Standard Forge Templates and the versioned engineering material catalog for Aetheris.</Description></PropertyGroup><ItemGroup>diff --git a/Aetheris.Modules.BuiltIn/Aetheris.Modules.BuiltIn.csproj b/Aetheris.Modules.BuiltIn/Aetheris.Modules.BuiltIn.csprojindex 9c02f723..945aff22 100644--- a/Aetheris.Modules.BuiltIn/Aetheris.Modules.BuiltIn.csproj+++ b/Aetheris.Modules.BuiltIn/Aetheris.Modules.BuiltIn.csproj@@ -1,5 +1,5 @@<Project Sdk="Microsoft.NET.Sdk">- <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable></PropertyGroup>+ <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable><Description>Built-in Surfacing, Piping, and Sheet Metal module registration for Aetheris.</Description></PropertyGroup><ItemGroup><ProjectReference Include="..\Aetheris.Modules\Aetheris.Modules.csproj" /><ProjectReference Include="..\Aetheris.Surfacing\Aetheris.Surfacing.csproj" />diff --git a/Aetheris.Modules/Aetheris.Modules.csproj b/Aetheris.Modules/Aetheris.Modules.csprojindex 6c3a8871..ca937a54 100644--- a/Aetheris.Modules/Aetheris.Modules.csproj+++ b/Aetheris.Modules/Aetheris.Modules.csproj@@ -3,5 +3,6 @@<TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>+ <Description>Capability and module contracts for extensible Aetheris engineering domains.</Description></PropertyGroup></Project>diff --git a/Aetheris.Piping/Aetheris.Piping.csproj b/Aetheris.Piping/Aetheris.Piping.csprojindex 0539739a..5160b68f 100644--- a/Aetheris.Piping/Aetheris.Piping.csproj+++ b/Aetheris.Piping/Aetheris.Piping.csproj@@ -1,5 +1,5 @@<Project Sdk="Microsoft.NET.Sdk">- <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable></PropertyGroup>+ <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable><Description>Semantic piping routes, fittings, and exact geometry lowering for Aetheris.</Description></PropertyGroup><ItemGroup><ProjectReference Include="..\Aetheris.Modules\Aetheris.Modules.csproj" /><ProjectReference Include="..\Aetheris.Kernel.Core\Aetheris.Kernel.Core.csproj" />diff --git a/Aetheris.Semantics/Aetheris.Semantics.csproj b/Aetheris.Semantics/Aetheris.Semantics.csprojindex 77fdc68a..9bc68002 100644--- a/Aetheris.Semantics/Aetheris.Semantics.csproj+++ b/Aetheris.Semantics/Aetheris.Semantics.csproj@@ -3,6 +3,7 @@<TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>+ <Description>Typed engineering semantics, quantities, capabilities, and validation contracts for Aetheris.</Description></PropertyGroup><ItemGroup><ProjectReference Include="..\Aetheris.Kernel.Core\Aetheris.Kernel.Core.csproj" />diff --git a/Aetheris.SheetMetal/Aetheris.SheetMetal.csproj b/Aetheris.SheetMetal/Aetheris.SheetMetal.csprojindex 5c46d0f2..ca31d0aa 100644--- a/Aetheris.SheetMetal/Aetheris.SheetMetal.csproj+++ b/Aetheris.SheetMetal/Aetheris.SheetMetal.csproj@@ -1,5 +1,5 @@<Project Sdk="Microsoft.NET.Sdk">- <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable></PropertyGroup>+ <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable><Description>Authored and reconstructed Sheet Metal semantics, flat patterns, DFM, and manufacturing output for Aetheris.</Description></PropertyGroup><ItemGroup><ProjectReference Include="..\Aetheris.Modules\Aetheris.Modules.csproj" /><ProjectReference Include="..\Aetheris.Surfacing\Aetheris.Surfacing.csproj" /></ItemGroup><ItemGroup><ProjectReference Include="..\Aetheris.Kernel.Core\Aetheris.Kernel.Core.csproj" /><ProjectReference Include="..\Aetheris.Kernel.Firmament\Aetheris.Kernel.Firmament.csproj" /></ItemGroup><ItemGroup><EmbeddedResource Include="Firmament\SheetMetalProductFamilies.firmament" /></ItemGroup>diff --git a/Aetheris.Surfacing/Aetheris.Surfacing.csproj b/Aetheris.Surfacing/Aetheris.Surfacing.csprojindex 0539739a..6a7f3e22 100644--- a/Aetheris.Surfacing/Aetheris.Surfacing.csproj+++ b/Aetheris.Surfacing/Aetheris.Surfacing.csproj@@ -1,5 +1,5 @@<Project Sdk="Microsoft.NET.Sdk">- <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable></PropertyGroup>+ <PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable><Description>Surface construction, fitting, and semantic surfacing operations for Aetheris.</Description></PropertyGroup><ItemGroup><ProjectReference Include="..\Aetheris.Modules\Aetheris.Modules.csproj" /><ProjectReference Include="..\Aetheris.Kernel.Core\Aetheris.Kernel.Core.csproj" />diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 6556e119..0627f551 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -1,48 +1,68 @@-# Contributing+# Contributing to Aetheris-## Development approach+Thank you for improving Aetheris. Keep changes focused, explain the engineering intent, and preserve the rule that supported semantics are emitted truthfully while unsupported semantics fail with actionable diagnostics.-- Work milestone-first: implement only the scoped behavior for the current milestone.-- Keep pull requests focused; avoid speculative feature branches folded into one PR.-- Prefer small, mergeable increments over broad framework design.+## Preview 3 status-## Testing expectations+`2.0.0-preview.3` is feature-frozen. Release-hygiene, documentation, tests, narrowly scoped correctness fixes, and post-Preview work on an explicitly agreed branch are appropriate; new Preview 3 CAD, Sheet Metal, PMI, FEA, Forge, material, platform, or Cadmata capability is not.-- Behavior changes require tests.-- Run .NET build/test checks locally before opening a PR.-- Prefer the automation-friendly repo entrypoint:+## Build and test- ```bash- export PATH="$HOME/.dotnet:$PATH"- ./scripts/test-all.sh- ```+Install the .NET SDK selected by [`global.json`](global.json), then use the canonical solution:-- The default script currently runs the full Firmament and Server suites plus `Aetheris.Kernel.Core.Tests` with `Category!=SlowCorpus` in a deterministic order. Use direct `dotnet test ...csproj` commands when you need broader or more targeted coverage.+```powershell+dotnet restore Aetheris.slnx+dotnet build Aetheris.slnx -c Release -m:1+dotnet test Aetheris.slnx -c Release --no-build -m:1 -- RunConfiguration.MaxCpuCount=1+```-- If you need a narrower repro, run the individual test projects directly:+Cadmata and the VS Code extension use TSPack and their checked-in lock files:- ```bash- export PATH="$HOME/.dotnet:$PATH"- dotnet test Aetheris.Kernel.Firmament.Tests/Aetheris.Kernel.Firmament.Tests.csproj --logger "console;verbosity=minimal"- dotnet test Aetheris.Server.Tests/Aetheris.Server.Tests.csproj --logger "console;verbosity=minimal"- dotnet test Aetheris.Kernel.Core.Tests/Aetheris.Kernel.Core.Tests.csproj --logger "console;verbosity=minimal"- ```+```powershell+Push-Location aetheris.client+tspack sync+tspack check+tspack run typecheck+tspack run test+tspack run build+tspack run lint+Pop-Location-- Use `Aetheris.slnx` as the canonical solution file. Default automation targets `net10.0` only. Legacy Firmament V1 and FrictionLab tests are opt-in with `AETHERIS_RUN_LEGACY_TESTS=1` or `./scripts/test-legacy.sh`; see `docs/build-test-policy-net10-and-legacy-v1.md`.+Push-Location tools/vscode-firmament+tspack sync+tspack check+tspack run typecheck+tspack run test+tspack run build+Pop-Location+```-## Frontend/display PR boundary checklist+Use `Aetheris.CLI` as the ground-truth inspection surface while developing:-Frontend/display PRs must state whether they change:+```powershell+dotnet run --project Aetheris.CLI -c Release -- --help+dotnet run --project Aetheris.CLI -c Release -- analyze path/to/part.step --json+```-- STEP import/export semantics;-- BRep topology;-- Firmament V2 lowering;-- AIR lowering;-- CIR authority;-- DisplayIR server authority;-- frontend rendering only.+The shell entry points under `scripts/` remain useful for targeted Linux/framework automation. The release qualification commands above are the authoritative Windows path for Preview 3.-## Kernel discipline+## Contribution expectations-- Do not introduce ad hoc epsilon constants; use `ToleranceContext` + `ToleranceMath` and follow `docs/numerics-policy.md`.-- Favor diagnostic/result-oriented kernel operations over exceptions for expected operation outcomes (future-facing rule).+- Keep pull requests small enough to review and test as one engineering claim.+- Add tests for behavior changes and run the affected real CLI, package, or UI path.+- Use `ToleranceContext` and `ToleranceMath`; do not introduce ad hoc geometry epsilon constants.+- State whether display work changes STEP semantics, BRep topology, Firmament/AIR/CIR lowering, DisplayIR authority, or frontend presentation only.+- Update public documentation whenever a user-visible command, boundary, diagnostic, or example changes.+- Put current user-facing behavior under [`docs/public`](docs/public/README.md). Architecture, experiments, and development evidence belong elsewhere under `docs/` and must not silently become the public contract.++## Rights and provenance++Submit only code, documentation, models, and assets that you have the right to contribute. Record third-party source, author, license, and redistribution constraints in the pull request and, when bundled, in [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md). Tool-assisted or AI-assisted work is acceptable, but the contributor remains responsible for the right to submit it and for reviewing its correctness and provenance.++## Contributor license agreement status++Aetheris intends to use a contributor-friendly CLA: contributors keep copyright, while granting the project owner enough non-exclusive rights to distribute contributions under AGPL-3.0 and alternative licenses. In return, the intended bargain commits Aetheris to continuing AGPL availability rather than using the CLA to make the community version proprietary-only.++The current [`CLA-CANDIDATE.md`](docs/legal/CLA-CANDIDATE.md) is **draft preparation for human attorney review**. It is not a final legal agreement and this repository does not yet define click-through, pull-request, or signature acceptance. Until counsel and the project owner publish approved terms and acceptance mechanics, maintainers should not represent a contribution as having accepted that draft.++Legal reviewers should also see the [`CLA counsel checklist`](docs/legal/CLA-COUNSEL-QUESTIONS.md).diff --git a/README.md b/README.mdindex bb21c392..db620100 100644--- a/README.md+++ b/README.md@@ -1,34 +1,80 @@# Aetheris 2.0.0-preview.3-Aetheris turns semantic engineering intent into deterministic CAD and analysis artifacts. Firmament V2 is its authoring language; the Aetheris compiler, geometry kernel, Standard Library, Sheet Metal and FEA modules lower that intent to STEP AP242, manufacturing outputs, and analysis results. Cadmata is the interactive 3D inspection surface, and Forge exposes qualified templates to other programs.+Aetheris is a semantic, compiler-style CAD system. You author engineering intent in **Firmament**; Aetheris lowers it through geometry, manufacturing, and analysis subsystems; **STEP AP242** is the primary exchange and product-definition artifact; **Cadmata** presents the resulting geometry and semantic PMI; and **Forge.Host** lets any process invoke qualified Firmament Templates without embedding the kernel.-Preview 3 is feature-frozen and qualified on Windows x64. It includes bounded exact geometry, typed Templates and static engineering data, STEP AP242 import/export, semantic PMI, authored and reconstructed Sheet Metal workflows, a linear-elastic FEA path, the material catalog, Cadmata, and Forge Host Protocol v1. The exact boundaries are in the [Preview 3 support matrix](docs/public/reference/supported-features.md).+```text+Firmament intent -> Aetheris lowering -> STEP AP242 / manufacturing / analysis+ | |+ +-> Forge.Host +-> Cadmata+```++Preview 3 is feature-frozen and qualified for **Windows x64**. Its public surface is deliberately bounded: supported operations produce inspectable artifacts, while unsupported intent fails with named diagnostics. See the [support matrix](docs/public/reference/supported-features.md) for the exact boundary.++++*The canonical ordinary-CAD witness: Boss, finite Pocket, hole family, perimeter EdgeFinish, AP242, and semantic PMI in Cadmata.*-## Start here+## What Preview 3 supports-- [Getting Started](docs/public/getting-started.md) — install, build a real part, inspect it, and invoke a Template.-- [Public documentation](docs/public/README.md) — authoritative user-facing Preview 3 behavior.-- [Firmament overview](docs/public/firmament/overview.md) — the language's engineering mental model.-- [CLI reference](docs/public/reference/cli.md) — stable commands and structured-output expectations.+- Firmament V2 semantic authoring with typed Records, Templates, Static specialization, tables, and engineering references+- bounded analytic and prismatic solid modeling, including connected Boss, finite Pocket, holes, slots, patterns, and admitted EdgeFinish routes+- deterministic STEP AP242 import/export and semantic manufacturing PMI+- formed and flat Sheet Metal workflows with material, bend, opening, DFM, STEP, and SVG outputs+- Cadmata 3D inspection with PMI filtering, associations, and selection+- a deployed Standard Library material catalog+- bounded cut-cell/vector-lattice linear-elastic FEA over native Firmament or qualified `inlineSTEP`+- Firmament Template discovery and invocation through Forge Host Protocol v1, qualified with Python, Go, Rust, and TypeScript clients-After publication, install the CLI with the .NET 10 SDK:+++*CTC-03 manufacturing AP242 in Cadmata: formed geometry, datums, dimensions, position controls, annotations, and geometry associations.*++## 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:```powershell-dotnet tool install --global Aetheris.CLI --prerelease+dotnet tool install --global Aetheris.CLI --version 2.0.0-preview.3aetheris --version+aetheris build fixtures/FirmamentV2/Canonical/valid/box-hole-pmi.firmament --output out/first-part.step --json+aetheris analyze out/first-part.step --json```-From a source checkout, use the same real CLI path without installing it:+Go next to [Getting Started](docs/public/getting-started.md), the [public documentation](docs/public/README.md), or the [CLI reference](docs/public/reference/cli.md). The [A4 machined mounting block](fixtures/FirmamentV2/Canonical/valid/a4-machined-mounting-block.firmament) is the canonical first serious CAD example; the [L-bracket](fixtures/FirmamentV2/SheetMetal/preview3-l-bracket-hole.firmament) is the introductory Sheet Metal example; and the [A36 cantilever](fixtures/FirmamentV2/PublicDogfood/ai-fea-a36-cantilever.firmament) is the analytically interpretable FEA witness.++++*A qualified flat-pattern artifact. Preview 3 emits formed STEP, flat STEP, SVG, bend identity, material identity, and DFM evidence on the documented Sheet Metal routes.*++## Why Aetheris?++Aetheris keeps engineering semantics alive through lowering instead of treating them as labels added after geometry. STEP AP242 is a primary artifact, PMI is semantic and associated with geometry, Sheet Metal carries formed/flat/fabrication meaning, and FEA consumes native or qualified imported STEP geometry. Forge.Host keeps cross-language integration small: clients list, describe, and invoke Templates through files and JSON.```powershell-dotnet run --project Aetheris.CLI -c Release -- build fixtures/FirmamentV2/Canonical/valid/box-holes-pmi-chamfer.firmament --output artifacts/mounting-plate.step --json-dotnet run --project Aetheris.CLI -c Release -- analyze artifacts/mounting-plate.step --json+$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```-The packaged CLI does not include Cadmata; use the Windows bundle for `aetheris view`. Maintainer build and test policy lives in [development documentation](docs/development/README.md). Historical milestone, experiment, architecture, and artifact reports remain valuable evidence, but they are not the public behavior contract.+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`.++## Installation surfaces++| Surface | Use | Preview 3 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 |+| 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.## License and acknowledgments-Aetheris source is licensed under GNU AGPL-3.0, except for third-party assets which retain their own licenses and attribution. Alternative licensing is available on request. See [LICENSE](LICENSE) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).+Aetheris code is licensed under the [GNU Affero General Public License v3.0](LICENSE). Alternative licensing is available on request. Third-party assets retain their own terms and provenance; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).++Special thanks to the National Institute of Standards and Technology (NIST) for STEP AP242 test models used in development and validation. Their presence does not imply NIST endorsement or place those models under the Aetheris license. Stanford Bunny provenance is recorded separately in the third-party notices.-Special thanks to the National Institute of Standards and Technology (NIST) for the STEP AP242 test models used in development and validation. Their inclusion does not imply NIST endorsement, authorship of Aetheris, or application of the Aetheris license to those models.+External contributions are welcome under the process in [CONTRIBUTING.md](CONTRIBUTING.md). The proposed contributor license agreement is a **candidate pending human attorney review** and is not yet an operative acceptance mechanism.diff --git a/docs/legal/CLA-CANDIDATE.md b/docs/legal/CLA-CANDIDATE.mdnew file mode 100644index 00000000..11bfe149--- /dev/null+++ b/docs/legal/CLA-CANDIDATE.md@@ -0,0 +1,40 @@+# Aetheris Contributor License Agreement — candidate for legal review++> **Status: candidate only; pending review by qualified human legal counsel.** This text is not legal advice, is not the operative contributor agreement, and does not define a method of acceptance. Do not sign or rely on it as final terms.++This candidate records the project's business intent in short, engineer-readable form so counsel can prepare the legally operative agreement.++## 1. Contributor and contribution++The contributor identifies the person making a contribution to Aetheris and confirms that they have authority to offer that contribution under this agreement. A “Contribution” is original code, documentation, models, assets, or other material intentionally submitted for inclusion in Aetheris under the future counsel-approved acceptance process.++## 2. Ownership++The contributor retains copyright and ownership in their Contribution. This agreement is intended to grant licenses, not to assign copyright.++## 3. License grant to the project owner++The contributor grants the Aetheris project owner a worldwide, royalty-free, non-exclusive license broad enough to use, reproduce, publicly display, publicly perform, modify, prepare derivative works of, distribute, sublicense, and license the Contribution as part of Aetheris:++- under GNU Affero General Public License v3.0; and+- under alternative or commercial licenses offered alongside the AGPL version.++Counsel must determine the exact operative wording, duration, revocability, sublicensing language, recipient, successor treatment, and whether any patent terms are appropriate.++## 4. Continuing AGPL availability++The intended exchange is: the contributor keeps ownership and permits AGPL and alternative licensing; the project owner commits that Aetheris will continue to be made available under GNU AGPL-3.0. Alternative licenses may coexist with the AGPL version but are not intended to replace it or turn the community version into a proprietary-only product.++Counsel must refine this commitment so contributors can understand and rely on its legally operative scope without accidentally preventing ordinary project evolution.++## 5. Right to contribute and restrictions++The contributor represents that they have the right to submit the Contribution and grant the required rights. The contributor will disclose known third-party licenses, employer ownership, confidentiality obligations, or other restrictions that may affect its use. The contributor does not knowingly submit material they are not authorized to contribute.++## 6. Warranty treatment++The project expects a conventional contribution “as is” and no-warranty provision, but counsel must decide whether and how to include it. No warranty language in this candidate should be treated as approved.++## 7. Review and acceptance++This candidate deliberately omits governing law, venue, arbitration, electronic-signature mechanics, corporate-contributor machinery, patent strategy, and employer-specific conclusions. It becomes operative only after human legal review, project-owner approval, publication of final text, and publication of an unambiguous acceptance process.diff --git a/docs/legal/CLA-COUNSEL-QUESTIONS.md b/docs/legal/CLA-COUNSEL-QUESTIONS.mdnew file mode 100644index 00000000..2e5a19ed--- /dev/null+++ b/docs/legal/CLA-COUNSEL-QUESTIONS.md@@ -0,0 +1,17 @@+# Aetheris CLA questions for counsel++The business intent is recorded in [`CLA-CANDIDATE.md`](CLA-CANDIDATE.md). Please resolve these questions before the CLA becomes operative:++- Who should initially receive the license: the project owner personally, an existing or future entity, or an identified assignable successor?+- Should the contributor grant be expressly irrevocable, perpetual, and transferable, and what limits should apply?+- What exact sublicensing and relicensing wording is needed for AGPL distribution and alternative/commercial licensing?+- Should the CLA include an express patent grant, patent-defense clause, or no patent language?+- How should employer-owned work and a contributor's authority to contribute be verified without making the individual agreement burdensome?+- Is a separate corporate contributor agreement needed?+- What electronic assent or signature method is sufficient, and how should identity and agreement versions be recorded?+- How should the AGPL-continuity commitment be phrased so contributors can rely on it while allowing maintenance, successors, and independently owned components?+- Should the commitment apply to the Aetheris project as a whole, accepted Contributions, specific branches/releases, or another precisely defined scope?+- What no-warranty, limitation-of-liability, governing-law, venue, privacy, and record-retention terms are actually necessary?+- How should third-party dependencies, reference datasets, generated artifacts, and contributions incorporating separately licensed material be handled?++No repository automation should collect CLA assent until these questions are resolved and final text is approved by qualified counsel.diff --git a/docs/public/assets/ordinary-cad-mounting-block.png b/docs/public/assets/ordinary-cad-mounting-block.pngnew file mode 100644index 00000000..9a4520d1Binary files /dev/null and b/docs/public/assets/ordinary-cad-mounting-block.png differdiff --git a/docs/public/assets/semantic-pmi-ctc03.png b/docs/public/assets/semantic-pmi-ctc03.pngnew file mode 100644index 00000000..d80b1316Binary files /dev/null and b/docs/public/assets/semantic-pmi-ctc03.png differdiff --git a/docs/public/assets/sheet-metal-flat-pattern.png b/docs/public/assets/sheet-metal-flat-pattern.pngnew file mode 100644index 00000000..073c8112Binary files /dev/null and b/docs/public/assets/sheet-metal-flat-pattern.png differdiff --git a/docs/public/getting-started.md b/docs/public/getting-started.mdindex 249af3e6..e1884624 100644--- a/docs/public/getting-started.md+++ b/docs/public/getting-started.md@@ -7,7 +7,7 @@ dotnet tool install --global Aetheris.CLI --prereleaseaetheris --help```-For a source checkout, replace `aetheris` below with `dotnet run --project Aetheris.CLI -c Release --`.+The release ZIP is the complete product path: run the commands below from its `Aetheris-win-x64` directory and use `.\aetheris.exe` in place of `aetheris`. It also supplies the `fixtures` used below and Cadmata for the final `view` command. For a source checkout, replace `aetheris` with `dotnet run --project Aetheris.CLI -c Release --`.## Build a first part@@ -19,10 +19,20 @@ aetheris build fixtures/FirmamentV2/Canonical/valid/box-hole-pmi.firmament --outaetheris analyze artifacts/first-part.step --json```-`validate` checks syntax, binding, units, targets, and supported/deferred PMI without materializing geometry. `build` runs the real geometry and AP242 path. In JSON, `success: true`, the output path, diagnostics, feature reports, and `pmiExportEvidence` describe what was actually emitted. `analyze` independently reinspects topology and semantic PMI.+`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.Use `aetheris view ...` to open Firmament or STEP in Cadmata when using the Windows bundle.+## Build the canonical ordinary-CAD example++[`a4-machined-mounting-block.firmament`](../../fixtures/FirmamentV2/Canonical/valid/a4-machined-mounting-block.firmament) is the first serious example after the small plate. It combines a base, connected Boss, finite Pocket, shaft hole, two counterbores, perimeter EdgeFinish, and semantic PMI while remaining a single readable source file:++```powershell+aetheris build fixtures/FirmamentV2/Canonical/valid/a4-machined-mounting-block.firmament --output artifacts/mounting-block.step --json+aetheris analyze artifacts/mounting-block.step --json+aetheris view artifacts/mounting-block.step+```+## Invoke a Template[`record-array-pattern-holes.firmament`](../../fixtures/FirmamentV2/Canonical/valid/record-array-pattern-holes.firmament) demonstrates typed Records, a static array, a Template, and `Pattern ... Over`:diff --git a/docs/public/reference/cli.md b/docs/public/reference/cli.mdindex 3f02bc80..cce00f72 100644--- a/docs/public/reference/cli.md+++ b/docs/public/reference/cli.md@@ -13,4 +13,4 @@ Primary public commands:| `sheetmetal ...` | Inspect, recognize, recover, compare, or flatten Sheet Metal || `asm ...` | Inspect/execute/import/export assemblies |-Run `aetheris <command> --help` for exact options. JSON is a public automation surface: `success` reflects the command result; diagnostics are structured; artifact paths are explicit; Sheet Metal reports regions, bends, and lowered features separately; FEA reports requested/result artifacts; builds report emitted features and PMI export evidence. Counts describe semantic items at the stated layer, not arbitrary STEP entity counts.+Run `aetheris <command> --help` for exact options. JSON is a public automation surface, but its root is command-specific: process exit status is authoritative, `validate` reports `firmamentV2Validation.status`, and materializing/analysis commands report `success` where documented. Diagnostics are structured; artifact paths are explicit; Sheet Metal reports regions, bends, and lowered features separately; FEA reports requested/result artifacts; builds report emitted features and PMI export evidence. Counts describe semantic items at the stated layer, not arbitrary STEP entity counts.diff --git a/docs/public/reference/release-notes.md b/docs/public/reference/release-notes.mdindex 862e5ded..a300c6a0 100644--- a/docs/public/reference/release-notes.md+++ b/docs/public/reference/release-notes.md@@ -1,25 +1,62 @@# Aetheris 2.0.0-preview.3 release notes-Preview 3 is a Windows x64 release candidate for integrated engineering workflows.+Preview 3 is the feature-frozen Windows x64 release of Aetheris's integrated semantic CAD workflow.-User-visible areas include:+## Firmament V2-- Firmament V2 authoring with typed Records, Templates, Static specialization, tables, semantic references, and explicit diagnostics.-- Bounded analytic and prismatic CAD, including first-class connected Boss and finite-depth Pocket semantics, semantic holes, admitted EdgeFinish routes, and deterministic STEP AP242 export.-- Bounded Sheet Metal base/flange/bend/opening workflows with formed STEP, flat STEP, SVG, material identity, bend identity, and DFM evidence.-- Semantic AP242 PMI for the qualified manufacturing families, including datums, dimensions, position controls, engineering annotations, and feature associations.-- Cadmata geometry inspection, selection, PMI filtering, datum/feature interaction, geometry-to-PMI discovery, and presentation-only callout dragging.-- A deployed Standard Library material catalog used by authored Sheet Metal and Firmament FEA.-- Bounded linear-elastic FEA over native Firmament geometry or qualified `inlineSTEP` bodies, with Fixed/Force conditions and typed displacement, strain, stress, and reaction-force results.-- Forge Host Protocol v1 discovery and deterministic invocation from foreign-language processes through the shipped NativeAOT host.-- A release ZIP containing the public documentation, executable examples, material catalog, CLI, Cadmata, Forge Host, and foreign-language clients.+- 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.-Important boundaries:+## Geometry-- Only `win-x64` release binaries are qualified.-- Geometry support is bounded; there is no general loft, helix, freeform feature family, or arbitrary solid Boolean authoring.-- Ordinary prismatic CAD STEP does not persist a general solid-material designation; material identity is qualified on the Sheet Metal and FEA paths.-- Sheet Metal and FEA support the documented bounded manufacturing and linear-elastic classes, not general formed-feature or physics systems.+- 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`.-See `known-issues.md` and `supported-features.md` for the precise release boundary.+## 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.diff --git a/docs/public/reference/supported-features.md b/docs/public/reference/supported-features.mdindex 23eb94e5..3816f47d 100644--- a/docs/public/reference/supported-features.md+++ b/docs/public/reference/supported-features.md@@ -14,7 +14,7 @@| Templates/Records/Static/Tables | Supported | Typed compile-time specialization, finite data, `with`, and `Require` || STEP AP242 export | Bounded | Deterministic single-body routes plus semantic PMI; unsupported intent fails loudly || STEP import / inlineSTEP | Bounded | Canonical single-body topology and recognized identities; arbitrary containment and multi-root bodies are not native-part promises |-| PMI authoring | Bounded | Plane Datum and toleranced shaft HoleDiameter AP242 export; broader PMI families are deferred |+| PMI authoring and presentation | Bounded | Model authoring qualifies plane Datum and toleranced shaft HoleDiameter; manufacturing AP242 workflows additionally qualify documented dimensions, position controls, annotations, and geometry associations; this is not general PMI authoring || Sheet Metal authoring | Bounded | Base/flanges/bends and planar circular holes/cuts, formed STEP, flat STEP/SVG, K-factor, DFM, semantic regions; Model `Hole<Counterbore>` / `Hole<Countersink>` syntax is rejected || Sheet Metal reconstruction | Experimental | Bounded recognition/recovery with explicit partial status and evidence || Materials | Supported | Four deployed Standard Library catalog entries |diff --git a/docs/public/release-bundle.md b/docs/public/release-bundle.mdindex 2b0bc284..954fea63 100644--- a/docs/public/release-bundle.md+++ b/docs/public/release-bundle.md@@ -14,4 +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/FirmamentV2`, 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`.+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.diff --git a/docs/release/PREVIEW3-CLAIMS.md b/docs/release/PREVIEW3-CLAIMS.mdnew file mode 100644index 00000000..006f84de--- /dev/null+++ b/docs/release/PREVIEW3-CLAIMS.md@@ -0,0 +1,20 @@+# Preview 3 factual launch claims++This is verification scaffolding, not launch or Hacker News prose. Counts and hashes must match the final A5 report before publication.++| Claim | Final A5 value | Evidence |+|---|---:|---|+| Qualified release target | Windows x64 (`win-x64`) | [`preview3-release-manifest.json`](preview3-release-manifest.json), final bundle smoke |+| Aetheris version | `2.0.0-preview.3` | `Directory.Build.props`, package audit, CLI `--version` |+| Forge Host protocol | v1 | packaged `info`/list/describe/invoke smoke |+| Foreign-language clients | Python, Go, Rust, TypeScript | shipped clients and protocol qualification; A4 proved byte-equivalent output |+| Public library packages | 16 | `scripts/package-public-libraries.ps1`, final package inventory |+| Cadmata tests | 81 passed in 16 files | final A5 validation report |+| VS Code tests | 13 passed | final A5 validation report |+| 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 |+| 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.mdnew file mode 100644index 00000000..17a6c775--- /dev/null+++ b/docs/release/PREVIEW3-HARDEN-A5.md@@ -0,0 +1,160 @@+# PREVIEW3-HARDEN-A5++## 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.++The final bounded smoke passed from a clean extraction of the Windows ZIP in a path+containing spaces. ReleaseBlocker and MustFix count: zero. The remaining boundaries+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 ZIP contains the self-contained CLI and Cadmata host, the NativeAOT Forge Host,+material catalog, public docs, licenses, tracked examples, and four foreign-language+client sources. Inspection found 672 archive entries under one+`Aetheris-win-x64/` root, no source/build/scratch directories, no PDBs, no stale+Preview version text, and no developer-machine paths.++## Public presentation++- The root README now explains the Firmament -> lowering -> STEP/Cadmata/Forge+ architecture, bounded capability set, Windows x64 qualification, installation+ surfaces, canonical examples, and AGPL/alternative-license position without+ milestone history.+- Three canonical images now live under `docs/public/assets`: the ordinary CAD+ mounting block, the CTC-03 semantic-PMI viewport, and a qualified Sheet Metal flat+ pattern. They are current Preview 3 assets with captions and no machine-local UI.+- Getting Started, CLI JSON-contract wording, release-bundle instructions, release+ notes, and the supported-feature PMI boundary were corrected against the shipped+ CLI. The canonical ordinary CAD, authored Sheet Metal, A36 FEA, and Forge examples+ are directly linked.+- The release notes are organized by product area. The user-facing known issues and+ support matrix were reviewed without broadening any claim.+- The NIST acknowledgment, Stanford Bunny provenance, third-party license boundary,+ AGPL-3.0 code license, and alternative-licensing statement remain visible.++## Release metadata and staging++- Aetheris/package version: `2.0.0-preview.3`.+- Qualified release RID: `win-x64` only.+- Public libraries: 16, plus the separately packaged `Aetheris.CLI` tool.+- Forge Host Protocol: v1, intentionally independent of the product version.+- Firmament VS Code extension: `0.3.0-preview.3`, intentionally independent.+- Expected tag: `v2.0.0-preview.3`.++All 17 NuGet packages have the expected version, non-generic descriptions, the real+repository URL, `AGPL-3.0-only` license expression, embedded README, and Preview 3+internal dependency versions. Public-library packaging now forces a rebuild so it+cannot silently reuse assemblies from an older commit. An isolated NuGet cache+proved the final packages report source revision `8b15c80376ccbe3d1e4487a48d96e753e407a4f7`.++The owner-facing tag checklist and factual GitHub release body are in+[`PREVIEW3-RELEASE-STAGING.md`](PREVIEW3-RELEASE-STAGING.md). No Hacker News title,+post, comment strategy, or launch copy was produced. The evidence-only claim sheet is+[`PREVIEW3-CLAIMS.md`](PREVIEW3-CLAIMS.md).++## CLA preparation++[`CLA-CANDIDATE.md`](../legal/CLA-CANDIDATE.md) records the requested business intent:+contributors retain ownership; the project receives broad, non-exclusive rights for+AGPL and alternative licensing; and alternative licensing must not replace continuing+AGPL availability. It is prominently marked candidate-only, not legal advice, not+operative, and pending qualified human attorney review. It deliberately defines no+acceptance mechanics.++[`CONTRIBUTING.md`](../../CONTRIBUTING.md) documents the build/test path, feature+freeze, engineering expectations, rights/provenance, practical AI-assisted-work+responsibility, and current CLA status. Unresolved recipient, irrevocability,+sublicensing, patent, employer/corporate, assent, continuity-scope, warranty, and+governing-law questions are handed to counsel in+[`CLA-COUNSEL-QUESTIONS.md`](../legal/CLA-COUNSEL-QUESTIONS.md), not guessed here.++## Final smoke++The exact ZIP was extracted to+`artifacts/a5 candidate smoke final/Aetheris-win-x64` and exercised without source+checkout runtime dependencies:++1. `aetheris.exe --help` started and exposed the public command surface.+2. The Getting Started PMI plate validated, built to STEP, and reimported as a+ seven-face part with one datum and one toleranced diameter.+3. The authored L-bracket built formed STEP and flattened to a 13,701-byte STEP plus+ 1,559-byte SVG.+4. The bundled cantilever resolved `standard:aluminum/6061-t6` and converged its+ linear-elastic solve.+5. NativeAOT Forge Host `info`, `list`, and `describe` returned Protocol v1 and five+ Templates; the shipped Python client invoked the enclosure Template and produced+ STEP, flat STEP, and SVG.+6. The packaged Cadmata production host served its application shell with HTTP 200.++A fresh external .NET project restored only from the final public-library directory+plus NuGet.org, with an isolated package cache. It loaded four package assemblies at+Preview 3/source revision `8b15c803`, resolved Aluminum 5052-H32 from the packaged+SQLite catalog, discovered five Forge Templates, invoked one through the direct API,+and reimported the emitted STEP AP242.++## Final validation++- Release build: pass, 0 warnings, 0 errors.+- Full serial .NET suite: 3,017 passed, 0 failed, 0 skipped. The pre-existing+ `Aetheris.FrictionLab.Tests` assembly still has no discoverable tests.+- Cadmata: typecheck, 16 files / 81 tests, production build, and lint pass.+- VS Code extension: typecheck, 13 tests, build, and VSIX packaging pass.+- Public docs/examples: expanded qualification covers root/public/release/package+ Markdown links and documented CAD, Sheet Metal, FEA, and Forge routes.+- NuGet: 16 public libraries plus CLI packed; metadata audit and isolated external+ restore/run pass.+- NativeAOT Forge publish: pass with the existing audited trimming/AOT warnings;+ packaged discovery/invocation pass.+- Release ZIP and checksum generation: pass; all 19 SHA-256 entries verified.+- Version/stale-path/archive-debris scans: pass.+- `git diff --check`: pass.++The release build and full serial suite were rerun after the final package metadata+changes. The later report/checksum edits do not change product code or binary payloads.++## Remaining known issues++The canonical list is [`known-issues.md`](../public/reference/known-issues.md). It+records Windows x64 qualification, bounded imported STEP containment, the generic+tessellated mass-verifier boundary, opening-domain limits, imported-unit metadata,+ordinary-CAD material persistence, and the harmless Cadmata Three.js warning. These+are documented Preview 3 boundaries, not unresolved release defects.++## Feature freeze++Feature freeze is intact. A5 changed public presentation, legal-review preparation,+package descriptions, artifact generation, fixture composition, validation coverage,+and release evidence only. It added no CAD, Firmament, Sheet Metal, PMI, FEA,+material, Forge protocol, Cadmata, platform, licensing-enforcement, or architecture+capability.diff --git a/docs/release/PREVIEW3-RELEASE-STAGING.md b/docs/release/PREVIEW3-RELEASE-STAGING.mdnew file mode 100644index 00000000..50e7b397--- /dev/null+++ b/docs/release/PREVIEW3-RELEASE-STAGING.md@@ -0,0 +1,60 @@+# Preview 3 release staging++## Tag and commit++- Expected annotated tag: `v2.0.0-preview.3`+- Version: `2.0.0-preview.3`+- Qualified RID: `win-x64`+- Forge Host Protocol: `1` (independently versioned)+- VS Code extension: `0.3.0-preview.3` (independently versioned)+- Publish/push status: not performed by A5++Create the tag only from the final clean release commit after the A5 report records the same commit and final artifact hashes.++## Required release assets++- `Aetheris-2.0.0-preview.3-win-x64.zip`+- `Aetheris.CLI.2.0.0-preview.3.nupkg`+- 16 public `Aetheris.*.2.0.0-preview.3.nupkg` library packages+- `aetheris-firmament-0.3.0-preview.3.vsix`+- `SHA256SUMS.txt`+- `RELEASE-INVENTORY.md`++After both package scripts succeed, consolidate the staged assets and regenerate the+canonical hashes and inventory from their actual bytes:++```powershell+.\scripts\finalize-publication.ps1 `+ -ReleaseDirectory artifacts/release/a5-final `+ -PublicLibrariesDirectory artifacts/release/a5-public-packages-publication+```++The public documentation is under [`docs/public`](../public/README.md). The canonical release notes and limitations are [`release-notes.md`](../public/reference/release-notes.md) and [`known-issues.md`](../public/reference/known-issues.md).++## GitHub release body candidate++Aetheris `2.0.0-preview.3` is the feature-frozen Windows x64 release of a semantic/compiler-style CAD system. Firmament engineering intent is lowered 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/TypeScript clients++Download the Windows ZIP for the complete product. The standalone CLI tool, 16 public libraries, and VS Code extension are separate assets. Preview 3 release binaries are qualified only for `win-x64`; geometry, imported STEP, Sheet Metal, PMI, and FEA boundaries are documented in [known issues](../public/reference/known-issues.md) and the [support matrix](../public/reference/supported-features.md).++Start with [Getting Started](../public/getting-started.md). Verify binary downloads with `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.++## 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.diff --git a/docs/release/preview3-release-manifest.json b/docs/release/preview3-release-manifest.jsonindex a9dc0471..15ee2906 100644--- a/docs/release/preview3-release-manifest.json+++ b/docs/release/preview3-release-manifest.json@@ -38,7 +38,7 @@}],"testCounts": {- "dotnet": 2971,+ "dotnet": 3017,"cadmata": 81,"vscodeExtension": 13},@@ -46,9 +46,9 @@"stepAp242": "114cd7c0c6a8a364b2943cc955a12d8a96b576a187dfc1957ea9f769296872be","flatStep": "88c437373fe4fdf91e8f0a5b5e0e5c135b290f0dfe18449ec3ee7c0970c1d075","svg": "1657e3bbc3ef418617b45c5d9ab76a96d70b0ba6356c0e88a7ba07edc18b6519",- "windowsBundle": "8e90475dd4189eb4f00c83c45ef0b9687d757e04a613ddf2ee1518c95506203d",- "firmamentVsix": "3f188020cdfc4908d49c0eb810baed4ec4b78e1eb8bd66d39553f4c4558587a4",- "cliNuget": "6f4b3a2724c382e99f84fd6f155538f2c44ff99a614f2c4deb5ca104bd09c0df"+ "windowsBundle": "2e6a8efabd83363a6e5af4be12f2d113cc626f2cd6d90902abb99bcc4fdb89b8",+ "firmamentVsix": "def44bc6a83aed90a67505987ec36d00aa134d900fab734c48b83d0aeb59f361",+ "cliNuget": "abe221bdb24e31b1cedd32b5b08fb3d220754f6254abd13a193758d3b5ebb07e"},"knownPackagingLimitations": ["Only win-x64 is qualified for Preview 3.",diff --git a/scripts/finalize-publication.ps1 b/scripts/finalize-publication.ps1new file mode 100644index 00000000..6f8ad354--- /dev/null+++ b/scripts/finalize-publication.ps1@@ -0,0 +1,62 @@+param(+ [Parameter(Mandatory = $true)]+ [string]$ReleaseDirectory,++ [Parameter(Mandatory = $true)]+ [string]$PublicLibrariesDirectory+)++$ErrorActionPreference = "Stop"++$releaseRoot = (Resolve-Path -LiteralPath $ReleaseDirectory).Path+$publicLibrariesRoot = (Resolve-Path -LiteralPath $PublicLibrariesDirectory).Path+$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)."+}++foreach ($package in $publicPackages) {+ Copy-Item -LiteralPath $package.FullName -Destination (Join-Path $publicPackageDestination $package.Name) -Force+}++$binaryArtifacts = @(+ Get-ChildItem -LiteralPath $releaseRoot -File -Recurse |+ Where-Object { $_.Extension -in @(".zip", ".vsix", ".nupkg") } |+ Sort-Object FullName+)++$releaseHashes = foreach ($artifact in $binaryArtifacts) {+ $relativePath = [System.IO.Path]::GetRelativePath($releaseRoot, $artifact.FullName).Replace("\", "/")+ $hash = (Get-FileHash -LiteralPath $artifact.FullName -Algorithm SHA256).Hash.ToLowerInvariant()+ [pscustomobject]@{+ Path = $relativePath+ Bytes = $artifact.Length+ Sha256 = $hash+ }+}++$checksumLines = $releaseHashes | ForEach-Object { "$($_.Sha256) $($_.Path)" }+Set-Content -LiteralPath (Join-Path $releaseRoot "SHA256SUMS.txt") -Value $checksumLines -Encoding utf8NoBOM++$inventoryLines = @(+ "# Preview 3 release inventory"+ ""+ "Generated from the staged publication directory. Hashes use SHA-256."+ ""+ "| Artifact | Bytes | SHA-256 |"+ "| --- | ---: | --- |"+)+$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."+)+Set-Content -LiteralPath (Join-Path $releaseRoot "RELEASE-INVENTORY.md") -Value $inventoryLines -Encoding utf8NoBOM++Write-Host "Finalized $($releaseHashes.Count) publication artifacts in $releaseRoot"+Write-Host "Checksums: $(Join-Path $releaseRoot 'SHA256SUMS.txt')"+Write-Host "Inventory: $(Join-Path $releaseRoot 'RELEASE-INVENTORY.md')"diff --git a/scripts/package-public-libraries.ps1 b/scripts/package-public-libraries.ps1index d2c9a3e2..e069582a 100644--- a/scripts/package-public-libraries.ps1+++ b/scripts/package-public-libraries.ps1@@ -77,7 +77,11 @@ $projects = @(Push-Location $repoRoottry {foreach ($project in $projects) {- dotnet pack $project --configuration Release --output $outputPath -p:PackageVersion=$Version+ # The package payload must not inherit assemblies from an earlier commit+ # or a RID-specific publish. Rebuild 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=falseif ($LASTEXITCODE -ne 0) {throw "dotnet pack failed for $project"}diff --git a/scripts/package-release.ps1 b/scripts/package-release.ps1index c92c1c9c..355e72bd 100644--- a/scripts/package-release.ps1+++ b/scripts/package-release.ps1@@ -145,6 +145,7 @@ $publicExamples = @('fixtures/FirmamentV2/Canonical/valid/profile-compose-l-bracket-counterbore-pmi.firmament','fixtures/FirmamentV2/Canonical/valid/record-array-pattern-holes.firmament','fixtures/FirmamentV2/Canonical/valid/table-template-concept-path-compose.firmament',+ 'fixtures/FirmamentV2/FEA/cantilever.firmament','fixtures/FirmamentV2/FEA/inline-step-through-hole.firmament','fixtures/FirmamentV2/InlineStep/testdata/canonical-through-hole.step','fixtures/FirmamentV2/Materials/catalog-material-coupon.firmament',@@ -199,4 +200,27 @@ try {}finally { $archive.Dispose() }$releaseFiles = @($zip, $extensionArtifact) + (Get-ChildItem -LiteralPath (Join-Path $output 'packages') -Filter '*.nupkg' -File | Select-Object -ExpandProperty FullName)-$releaseFiles | ForEach-Object { Get-FileHash -LiteralPath $_ -Algorithm SHA256 } | ForEach-Object { "{0} {1}" -f $_.Hash.ToLowerInvariant(), $_.Path.Substring($output.Length + 1) } | Set-Content (Join-Path $output 'SHA256SUMS.txt')+$releaseHashes = @($releaseFiles | ForEach-Object {+ $item = Get-Item -LiteralPath $_+ $hash = Get-FileHash -LiteralPath $_ -Algorithm SHA256+ [pscustomobject]@{+ Path = $item.FullName.Substring($output.Length + 1).Replace('\', '/')+ Bytes = $item.Length+ Sha256 = $hash.Hash.ToLowerInvariant()+ }+})+$releaseHashes | ForEach-Object { "{0} {1}" -f $_.Sha256, $_.Path } | Set-Content (Join-Path $output 'SHA256SUMS.txt')++$inventory = @(+ "# Aetheris $Version publication inventory",+ "",+ "Qualified release target: Windows x64 (`win-x64`). Forge Host Protocol v1 and the VS Code extension version are independently versioned.",+ "",+ "| Artifact | Bytes | SHA-256 |",+ "|---|---:|---|"+)+$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.")+[IO.File]::WriteAllLines((Join-Path $output 'RELEASE-INVENTORY.md'), [string[]]$inventory, [Text.UTF8Encoding]::new($false))