Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Improve Firmament language tooling and editor integration
Yuechen Lid077fcaebabe
diff --git a/Aetheris.CLI.Tests/CadmataViewTests.cs b/Aetheris.CLI.Tests/CadmataViewTests.csindex 4cd38380..eef0faef 100644--- a/Aetheris.CLI.Tests/CadmataViewTests.cs+++ b/Aetheris.CLI.Tests/CadmataViewTests.cs@@ -196,7 +196,7 @@ public sealed class CadmataViewTestspublic string AddPackagedCadmata(){- var path = Path.Combine(CliBase, "cadmata", "Cadmata.exe");+ var path = Path.Combine(CliBase, "cadmata", OperatingSystem.IsWindows() ? "Cadmata.exe" : "Cadmata");Directory.CreateDirectory(Path.GetDirectoryName(path)!);File.WriteAllText(path, "placeholder");return path;diff --git a/Aetheris.CLI.Tests/LocalizedTangentBlendFilletPipelineTests.cs b/Aetheris.CLI.Tests/LocalizedTangentBlendFilletPipelineTests.csindex 4826a682..1524a8c5 100644--- a/Aetheris.CLI.Tests/LocalizedTangentBlendFilletPipelineTests.cs+++ b/Aetheris.CLI.Tests/LocalizedTangentBlendFilletPipelineTests.cs@@ -43,7 +43,8 @@ public sealed class LocalizedTangentBlendFilletPipelineTestsvar stepPath = json.RootElement.GetProperty("outputPath").GetString()!;var bytes = File.ReadAllBytes(stepPath);- Assert.Contains("TRIMMED_CURVE", Encoding.UTF8.GetString(bytes), StringComparison.Ordinal);+ Assert.Contains("CIRCLE", Encoding.UTF8.GetString(bytes), StringComparison.Ordinal);+ Assert.DoesNotContain("TRIMMED_CURVE", Encoding.UTF8.GetString(bytes), StringComparison.Ordinal);Assert.Equal(Convert.ToHexString(SHA256.HashData(bytes)), Convert.ToHexString(SHA256.HashData(File.ReadAllBytes(JsonDocument.Parse(second.Output).RootElement.GetProperty("outputPath").GetString()!))));var imported = Step242Importer.ImportBody(Encoding.UTF8.GetString(bytes));Assert.True(imported.IsSuccess, string.Join(Environment.NewLine, imported.Diagnostics.Select(d => d.Message)));diff --git a/Aetheris.CLI.Tests/ThreeDmBrepBindLocalTests.cs b/Aetheris.CLI.Tests/ThreeDmBrepBindLocalTests.csindex b1f810a3..12cdd125 100644--- a/Aetheris.CLI.Tests/ThreeDmBrepBindLocalTests.cs+++ b/Aetheris.CLI.Tests/ThreeDmBrepBindLocalTests.cs@@ -16,7 +16,8 @@ public sealed class ThreeDmBrepBindLocalTestsvar report = ThreeDmStepRecovery.Run(source, output, emitCombinedStep: true);Assert.Equal(27, report.Bodies.Count);- Assert.Equal(27, report.QualifiedBodyCount);+ Assert.True(report.QualifiedBodyCount == 27, string.Join("; ", report.Bodies+ .Where(body => !body.StepReimported).SelectMany(body => body.Diagnostics)));Assert.Equal(0, report.PartialBodyCount);Assert.Equal(185, report.BoundFaceCount);Assert.Equal(742, report.BoundTrimCount);diff --git a/Aetheris.CLI/CadmataLaunch.cs b/Aetheris.CLI/CadmataLaunch.csindex 1db4a725..b2643450 100644--- a/Aetheris.CLI/CadmataLaunch.cs+++ b/Aetheris.CLI/CadmataLaunch.cs@@ -35,11 +35,12 @@ public static class CadmataDiscoveryif (File.Exists(fullPath)) return new CadmataDiscoveryResult(fullPath, candidate.Source);}+ var executableName = OperatingSystem.IsWindows() ? "Cadmata.exe" : "Cadmata";var packagedCandidates = new[]{- (Path: Path.Combine(cliBaseDirectory, "Cadmata.exe"), Source: "sibling Cadmata executable"),- (Path: Path.Combine(cliBaseDirectory, "cadmata", "Cadmata.exe"), Source: "package-relative cadmata directory"),- (Path: Path.Combine(cliBaseDirectory, "tools", "cadmata", "Cadmata.exe"), Source: "package-relative tools/cadmata directory"),+ (Path: Path.Combine(cliBaseDirectory, executableName), Source: "sibling Cadmata executable"),+ (Path: Path.Combine(cliBaseDirectory, "cadmata", executableName), Source: "package-relative cadmata directory"),+ (Path: Path.Combine(cliBaseDirectory, "tools", "cadmata", executableName), Source: "package-relative tools/cadmata directory"),};foreach (var candidate in packagedCandidates)@@ -75,7 +76,7 @@ public static class CadmataDiscoveryif (directory is null) return null;foreach (var configuration in new[] { "Release", "Debug" }){- var candidate = Path.Combine(directory.FullName, "Aetheris.Server", "bin", configuration, "net10.0", "Cadmata.exe");+ var candidate = Path.Combine(directory.FullName, "Aetheris.Server", "bin", configuration, "net10.0", OperatingSystem.IsWindows() ? "Cadmata.exe" : "Cadmata");if (File.Exists(candidate)) return new CadmataDiscoveryResult(candidate, "development build fallback");}@@ -95,7 +96,7 @@ internal sealed class SystemCadmataProcessLauncher : ICadmataProcessLaunchervar startInfo = new ProcessStartInfo(executablePath){UseShellExecute = true,- WindowStyle = ProcessWindowStyle.Hidden,+ WindowStyle = ProcessWindowStyle.Normal,WorkingDirectory = Path.GetDirectoryName(executablePath) ?? AppContext.BaseDirectory,};startInfo.ArgumentList.Add(stepPath);diff --git a/Aetheris.Cadmata.Desktop/Program.cs b/Aetheris.Cadmata.Desktop/Program.csindex d2ffb1c9..625e53fb 100644--- a/Aetheris.Cadmata.Desktop/Program.cs+++ b/Aetheris.Cadmata.Desktop/Program.cs@@ -43,6 +43,7 @@ internal sealed class CadmataWindow : Form{private readonly WebView2 _view = new() { Dock = DockStyle.Fill };private readonly Label _status = new() { Dock = DockStyle.Fill, Text = "Starting Cadmata…", TextAlign = ContentAlignment.MiddleCenter };+ private readonly Panel _runtimeHelp = new() { Dock = DockStyle.Fill, Visible = false };private readonly DiagnosticLog _log;private readonly CancellationTokenSource _lifetime = new();private Microsoft.AspNetCore.Builder.WebApplication? _server;@@ -50,6 +51,7 @@ internal sealed class CadmataWindow : Formprivate readonly string[] _args;private bool _closing;private bool _shutdownComplete;+ private bool _initializing;internal CadmataWindow(string[] args, DiagnosticLog log){@@ -59,6 +61,20 @@ internal sealed class CadmataWindow : FormText = "Cadmata — Aetheris " + Program.BuildIdentity.Split('+')[0];Width = 1440; Height = 960; MinimumSize = new Size(900, 600);Controls.Add(_view); Controls.Add(_status);+ var runtimeMessage = new Label { Dock = DockStyle.Top, Height = 130, TextAlign = ContentAlignment.MiddleCenter,+ Text = "Cadmata needs the Microsoft Edge WebView2 Runtime.\n\nInstall the Evergreen Runtime from Microsoft, then select Retry.\nThe Edge browser alone is not a substitute. Local CAD works offline once the runtime is installed." };+ var runtimeActions = new FlowLayoutPanel { Dock = DockStyle.Top, Height = 50, Padding = new Padding(20, 5, 0, 0) };+ var installRuntime = new Button { Text = "Get WebView2 from Microsoft", AutoSize = true };+ installRuntime.Click += (_, _) =>+ {+ try { Process.Start(new ProcessStartInfo("https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section") { UseShellExecute = true }); }+ catch (Exception exception) { _log.Write("runtime download page " + exception); MessageBox.Show("Open https://developer.microsoft.com/microsoft-edge/webview2/ in your browser to install the Evergreen Runtime.", "Install WebView2"); }+ };+ var retryRuntime = new Button { Text = "Retry", AutoSize = true };+ retryRuntime.Click += async (_, _) => await InitializeAsync();+ runtimeActions.Controls.Add(installRuntime); runtimeActions.Controls.Add(retryRuntime);+ _runtimeHelp.Controls.Add(runtimeActions); _runtimeHelp.Controls.Add(runtimeMessage);+ Controls.Add(_runtimeHelp);var menu = new MenuStrip();menu.Items.Add("About Cadmata", null, (_, _) => MessageBox.Show($"Cadmata — Aetheris\n{Program.BuildIdentity}\n\nLogs: {_log.Path}\nSource: https://github.com/yuechen-li-dev/Aetheris",@@ -70,14 +86,29 @@ internal sealed class CadmataWindow : Formprivate async Task InitializeAsync(){+ if (_initializing || _lifetime.IsCancellationRequested) return;+ _initializing = true;+ _runtimeHelp.Visible = false;try{- var runtime = System.IO.Path.Combine(AppContext.BaseDirectory, "webview2");- if (!File.Exists(System.IO.Path.Combine(runtime, "msedgewebview2.exe")))- throw new FileNotFoundException("Bundled WebView2 runtime is missing. Extract the complete Cadmata ZIP again.");- var options = CadmataLaunchOptions.Parse(_args.Length == 0- ? [System.IO.Path.Combine(AppContext.BaseDirectory, "samples", "mounting-block.firmament")]- : _args);+ var bundledRuntime = System.IO.Path.Combine(AppContext.BaseDirectory, "webview2");+ string? runtime = Directory.Exists(bundledRuntime) ? bundledRuntime : null;+ if (runtime is not null && !File.Exists(System.IO.Path.Combine(runtime, "msedgewebview2.exe")))+ throw new FileNotFoundException("The optional bundled WebView2 runtime is incomplete. Extract the complete offline package to a fresh folder.");+ var browserOptions = new CoreWebView2EnvironmentOptions { ReleaseChannels = CoreWebView2ReleaseChannels.Stable };+ try+ {+ var version = CoreWebView2Environment.GetAvailableBrowserVersionString(runtime, browserOptions);+ _log.Write($"webview2 runtime mode={(runtime is null ? "Evergreen" : "Fixed")} version={version}");+ }+ catch (WebView2RuntimeNotFoundException)+ {+ _log.Write("webview2 runtime unavailable; awaiting user installation");+ _runtimeHelp.Visible = true;+ _runtimeHelp.BringToFront();+ return;+ }+ var options = CadmataLaunchOptions.Parse(_args);options.ValidateProductionAssets(AppContext.BaseDirectory);var token = Convert.ToHexString(RandomNumberGenerator.GetBytes(32));_server = CadmataApplication.Create([], options, portable: true, logging: _log.Provider, sessionToken: token);@@ -93,7 +124,7 @@ internal sealed class CadmataWindow : FormBeginInvoke(() => ShowFailure(new InvalidOperationException("The local CAD service stopped unexpectedly. Reopen Cadmata.")));});Directory.CreateDirectory(_profile);- var environment = await CoreWebView2Environment.CreateAsync(runtime, _profile);+ var environment = await CoreWebView2Environment.CreateAsync(runtime, _profile, browserOptions);await _view.EnsureCoreWebView2Async(environment).WaitAsync(startup.Token);if (_lifetime.IsCancellationRequested) return;_view.CoreWebView2.Settings.AreDevToolsEnabled = false;@@ -134,6 +165,7 @@ internal sealed class CadmataWindow : Form}catch (OperationCanceledException) when (_lifetime.IsCancellationRequested) { }catch (Exception exception) { if (!IsDisposed) ShowFailure(exception); }+ finally { _initializing = false; }}internal void ShowFailure(Exception exception)diff --git a/Aetheris.Forge.Host/ForgeProtocolContracts.cs b/Aetheris.Forge.Host/ForgeProtocolContracts.csindex e96285ad..21e31549 100644--- a/Aetheris.Forge.Host/ForgeProtocolContracts.cs+++ b/Aetheris.Forge.Host/ForgeProtocolContracts.cs@@ -9,7 +9,9 @@ public static class ForgeHostProtocolpublic const string Name = "Forge Host Protocol";}+[JsonConverter(typeof(JsonStringEnumConverter<ForgeProtocolDiagnosticSeverity>))]public enum ForgeProtocolDiagnosticSeverity { Info, Warning, Error }+[JsonConverter(typeof(JsonStringEnumConverter<ForgeArtifactKind>))]public enum ForgeArtifactKind { StepAp242, FlatStep, Svg, CutListJson }public sealed record ForgeHostInfo(diff --git a/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.cs b/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.csindex 2d7e859c..c3a7b6a6 100644--- a/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.cs+++ b/Aetheris.Kernel.Core.Tests/Brep/Surgery/BrepSurgeryRecipeParityTests.cs@@ -4,6 +4,8 @@ using Aetheris.Kernel.Core.Brep;using Aetheris.Kernel.Core.Brep.Boolean;using Aetheris.Kernel.Core.Brep.Verification;using Aetheris.Kernel.Core.Step242;+using Aetheris.Kernel.Core.Geometry;+using Aetheris.Kernel.Core.Math;using Aetheris.Kernel.StandardLibrary;namespace Aetheris.Kernel.Core.Tests.Brep.Surgery;@@ -29,7 +31,8 @@ public sealed class BrepSurgeryRecipeParityTestsnew AxisAlignedBoxExtents(5d, 15d, -3d, 3d, -45d, 45d)).Value;var body = BrepBoolean.Subtract(shaft, tool).Value;- AssertCanonical(body, 8, 12, 6, "3b5b0ee1132a27427365ec19e9c6973cd702d3a5d27e8f4c977ea745ee79b12e", expectClosedManifold: true);+ // Partial circular edges now reference legal CIRCLE bases; geometry is unchanged.+ AssertCanonical(body, 8, 12, 6, "9e3ae6915a10875e081e9eaa9f676f4e8e7bda8ed05a1872ab81da0dbf709fb0", expectClosedManifold: true);}[Fact]@@ -63,6 +66,13 @@ public sealed class BrepSurgeryRecipeParityTestsvar reimport = Step242Importer.ImportBody(export.Value);Assert.True(reimport.IsSuccess, string.Join(Environment.NewLine, reimport.Diagnostics.Select(diagnostic => diagnostic.Message)));Assert.True(BrepBindingValidator.Validate(reimport.Value, requireAllEdgeAndFaceBindings: true).IsSuccess);+ var sourceSamples = SampleEdges(body);+ var reimportedSamples = SampleEdges(reimport.Value);+ Assert.Equal(sourceSamples.Length, reimportedSamples.Length);+ foreach (var sample in sourceSamples)+ Assert.True(reimportedSamples.Min(point => (point - sample).Length) < 1e-7d);+ foreach (var sample in reimportedSamples)+ Assert.True(sourceSamples.Min(point => (point - sample).Length) < 1e-7d);if (expectClosedManifold){var mass = BrepMassProperties.Evaluate(reimport.Value);@@ -73,4 +83,20 @@ public sealed class BrepSurgeryRecipeParityTestsprivate static string Sha256(string value)=> Convert.ToHexString(SHA256.HashData(Encoding.UTF8.GetBytes(value))).ToLowerInvariant();++ private static Point3D[] SampleEdges(BrepBody body) => body.Bindings.EdgeBindings.SelectMany(binding =>+ {+ var curve = body.GetEdgeCurve(binding.EdgeId);+ var interval = binding.TrimInterval!.Value;+ return Enumerable.Range(0, 5).Select(i =>+ {+ var t = interval.Start + (interval.End - interval.Start) * i / 4d;+ return curve.Kind switch+ {+ CurveGeometryKind.Line3 => curve.Line3!.Value.Evaluate(t),+ CurveGeometryKind.Circle3 => curve.Circle3!.Value.Evaluate(t),+ _ => throw new InvalidOperationException($"Unexpected recipe curve {curve.Kind}."),+ };+ });+ }).ToArray();}diff --git a/Aetheris.Kernel.Core.Tests/Brep/Tessellation/PlanarMeshQualityTests.cs b/Aetheris.Kernel.Core.Tests/Brep/Tessellation/PlanarMeshQualityTests.csindex 3eb74c46..d2ae9c63 100644--- a/Aetheris.Kernel.Core.Tests/Brep/Tessellation/PlanarMeshQualityTests.cs+++ b/Aetheris.Kernel.Core.Tests/Brep/Tessellation/PlanarMeshQualityTests.cs@@ -5,6 +5,20 @@ namespace Aetheris.Kernel.Core.Tests.Brep.Tessellation;public sealed class PlanarMeshQualityTests{+ [Theory]+ [InlineData(-1e-14d, true)]+ [InlineData(0d, true)]+ [InlineData(1e-14d, true)]+ [InlineData(-.01d, true)]+ [InlineData(.01d, false)]+ public void QuadDiagonal_UsesStableRoundingTiesButRetainsTheShorterSplit(double perturbation, bool ac)+ {+ Point3D[] points = [new(0, 0, 0), new(1, 0, 0), new(1 + perturbation, 1, 0), new(0, 1, 0)];+ var indices = new List<int>();+ SurfaceMeshIrTessellator.AppendQuadTriangles(points, [0, 1, 2, 3], indices);+ Assert.Equal(ac ? new[] { 0, 1, 2, 0, 2, 3 } : [0, 1, 3, 1, 2, 3], indices);+ }+[Fact]public void InteriorFillPreservesConcaveDomainAndBoundaryWhileImprovingPointDistribution(){diff --git a/Aetheris.Kernel.Core.Tests/Step242/AnalyticIsoParametricPcurveTests.cs b/Aetheris.Kernel.Core.Tests/Step242/AnalyticIsoParametricPcurveTests.csnew file mode 100644index 00000000..e2ae20aa--- /dev/null+++ b/Aetheris.Kernel.Core.Tests/Step242/AnalyticIsoParametricPcurveTests.cs@@ -0,0 +1,64 @@+using Aetheris.Kernel.Core.Brep;+using Aetheris.Kernel.Core.Geometry;+using Aetheris.Kernel.Core.Geometry.Curves;+using Aetheris.Kernel.Core.Geometry.Surfaces;+using Aetheris.Kernel.Core.Math;++namespace Aetheris.Kernel.Core.Tests.Step242;++public sealed class AnalyticIsoParametricPcurveTests+{+ [Theory]+ [InlineData(0, 1)]+ [InlineData(0, -1)]+ [InlineData(1, 1)]+ [InlineData(1, -1)]+ [InlineData(2, 1)]+ [InlineData(2, -1)]+ [InlineData(3, 1)]+ [InlineData(3, -1)]+ public void RotatedAnalyticEdges_HaveExactLinearUvIncludingMultipleTurns(int family, int sense)+ {+ var origin = new Point3D(11, -7, 19);+ var axis = Direction3D.Create(new Vector3D(1, 2, 3));+ var reference = Direction3D.Create(new Vector3D(2, -1, 0));+ var cylinder = new CylinderSurface(origin, axis, 2, reference);+ var torus = new TorusSurface(origin, axis, 5, 2, reference);+ var radial = torus.XAxis.ToVector() * double.Cos(.8) + torus.YAxis.ToVector() * double.Sin(.8);+ var curve = family switch+ {+ 0 => CurveGeometry.FromLine(new(cylinder.Evaluate(.8, 3), Direction3D.Create(axis.ToVector() * sense))),+ 1 => CurveGeometry.FromCircle(new(origin + axis.ToVector() * 3, Direction3D.Create(axis.ToVector() * sense), 2, reference)),+ 2 => CurveGeometry.FromCircle(new(origin + axis.ToVector() * (2 * double.Sin(.6)), Direction3D.Create(axis.ToVector() * sense), 5 + 2 * double.Cos(.6), reference)),+ _ => CurveGeometry.FromCircle(new(origin + radial * 5, Direction3D.Create(radial.Cross(axis.ToVector()) * sense), 2, Direction3D.Create(radial))),+ };+ var surface = family < 2 ? SurfaceGeometry.FromCylinder(cylinder) : SurfaceGeometry.FromTorus(torus);+ var interval = new ParameterInterval(-.9, -.9 + 1.5 * double.Tau);+ var uv = Assert.IsType<PcurveGeometry>(BrepPcurveRecovery.TryBuildIsoParametricPcurve(surface, curve, interval));+ Assert.Equal(PcurveGeometryKind.Line, uv.Kind);+ Assert.Null(uv.PolynomialCurve);+ for (var i = 0; i <= 1000; i++)+ {+ var t = interval.Start + (interval.End - interval.Start) * i / 1000d;+ var p = uv.Evaluate(t);+ var lifted = family < 2 ? cylinder.Evaluate(p.U, p.V) : torus.Evaluate(p.U, p.V);+ var expected = family == 0 ? curve.Line3!.Value.Evaluate(t) : curve.Circle3!.Value.Evaluate(t);+ Assert.True((lifted - expected).Length < 1e-11, $"family {family}, sense {sense}, t={t:R}");+ }+ }++ [Fact]+ public void OffSupportOrObliqueEdges_DoNotTakeTheExactPath()+ {+ var axis = Direction3D.Create(new Vector3D(0, 0, 1));+ var reference = Direction3D.Create(new Vector3D(1, 0, 0));+ var cylinder = SurfaceGeometry.FromCylinder(new(new(0, 0, 0), axis, 2, reference));+ var torus = SurfaceGeometry.FromTorus(new(new(0, 0, 0), axis, 5, 2, reference));+ var domain = new ParameterInterval(0, double.Tau);+ // Even a sub-import-tolerance mismatch must not be called exact.+ var wrongRadius = CurveGeometry.FromCircle(new(new(0, 0, 0), axis, 2.00001, reference));+ var oblique = CurveGeometry.FromCircle(new(new(5, 0, 0), Direction3D.Create(new Vector3D(0, 1, .1)), 2, reference));+ Assert.Null(BrepPcurveRecovery.TryBuildIsoParametricPcurve(cylinder, wrongRadius, domain));+ Assert.Null(BrepPcurveRecovery.TryBuildIsoParametricPcurve(torus, oblique, domain));+ }+}diff --git a/Aetheris.Kernel.Core.Tests/Step242/Step242ExporterTests.cs b/Aetheris.Kernel.Core.Tests/Step242/Step242ExporterTests.csindex fbc836c1..20f4efd2 100644--- a/Aetheris.Kernel.Core.Tests/Step242/Step242ExporterTests.cs+++ b/Aetheris.Kernel.Core.Tests/Step242/Step242ExporterTests.cs@@ -11,6 +11,37 @@ public sealed class Step242ExporterTests{private const double EdgeOnLineTolerance = 1e-6;+ [Theory]+ [InlineData("cylinder", false)]+ [InlineData("cylinder", true)]+ [InlineData("torus", false)]+ [InlineData("sphere", false)]+ [InlineData("slot", false)]+ public void AnalyticEdges_UseAdmittedBasisCurvesWithoutTrimmedWrappers(string primitive, bool legacyTrimOption)+ {+ var body = primitive switch+ {+ "cylinder" => BrepPrimitives.CreateCylinder(2d, 10d).Value,+ "torus" => BrepPrimitives.CreateTorus(5d, 1d).Value,+ "sphere" => BrepPrimitives.CreateSphere(2d).Value,+ _ => BrepPrimitives.CreateStraightSlot(10d, 4d, 3d).Value,+ };+ var exported = Step242Exporter.ExportBody(body, new Step242ExportOptions { EmitFullCircleTrimmedCurves = legacyTrimOption });+ Assert.True(exported.IsSuccess, string.Join(" | ", exported.Diagnostics.Select(d => d.Message)));+ var document = Step242SubsetParser.Parse(exported.Value).Value;+ foreach (var edge in document.Entities.Where(e => e.Name == "EDGE_CURVE"))+ {+ var basisId = Step242SubsetDecoder.ReadReference(edge, 3, "edge basis").Value.TargetId;+ var basis = document.Entities.Single(e => e.Id == basisId);+ Assert.Contains(basis.Name, new[] { "LINE", "CIRCLE", "ELLIPSE", "HYPERBOLA", "B_SPLINE_CURVE_WITH_KNOTS", "SURFACE_CURVE", "SEAM_CURVE" });+ }+ Assert.DoesNotContain("TRIMMED_CURVE", exported.Value, StringComparison.Ordinal);+ var imported = Step242Importer.ImportBody(exported.Value);+ Assert.True(imported.IsSuccess, string.Join(" | ", imported.Diagnostics.Select(d => d.Message)));+ Assert.Equal(body.Topology.Faces.Count(), imported.Value.Topology.Faces.Count());+ Assert.Equal(body.Topology.Edges.Count(), imported.Value.Topology.Edges.Count());+ }+[Theory][InlineData(4.414213562373095, 4.414213562373094, "4.4142135623731")][InlineData(0.634393284163645, 0.634393284163646, "0.6343932841636")]diff --git a/Aetheris.Kernel.Core.Tests/Step242/Step242HyperbolaEdgeTests.cs b/Aetheris.Kernel.Core.Tests/Step242/Step242HyperbolaEdgeTests.csindex 8b1cccf1..7fef2766 100644--- a/Aetheris.Kernel.Core.Tests/Step242/Step242HyperbolaEdgeTests.cs+++ b/Aetheris.Kernel.Core.Tests/Step242/Step242HyperbolaEdgeTests.cs@@ -19,7 +19,7 @@ public sealed class Step242HyperbolaEdgeTestsAssert.True(exported.IsSuccess, string.Join(Environment.NewLine, exported.Diagnostics.Select(d => d.Message)));Assert.Contains("HYPERBOLA", exported.Value, StringComparison.Ordinal);- Assert.Contains("TRIMMED_CURVE", exported.Value, StringComparison.Ordinal);+ Assert.DoesNotContain("TRIMMED_CURVE", exported.Value, StringComparison.Ordinal);var imported = Step242Importer.ImportBody(exported.Value);Assert.True(imported.IsSuccess, string.Join(Environment.NewLine, imported.Diagnostics.Select(d => d.Message)));diff --git a/Aetheris.Kernel.Core.Tests/Step242/Step242PcurveAndVertexLoopTests.cs b/Aetheris.Kernel.Core.Tests/Step242/Step242PcurveAndVertexLoopTests.csindex efaf8c62..c2673df4 100644--- a/Aetheris.Kernel.Core.Tests/Step242/Step242PcurveAndVertexLoopTests.cs+++ b/Aetheris.Kernel.Core.Tests/Step242/Step242PcurveAndVertexLoopTests.cs@@ -10,6 +10,30 @@ namespace Aetheris.Kernel.Core.Tests.Step242;public sealed class Step242PcurveAndVertexLoopTests{+ [Theory]+ [InlineData(-2e-9d)]+ [InlineData(2e-9d)]+ public void CircularSeamRoundoff_PreservesConicPcurvesAcrossTheParameterPeriod(double seamAngle)+ {+ var source = AddCylinderPcurves(BrepPrimitives.CreateCylinder(2d, 10d).Value);+ var points = source.Topology.Vertices.ToDictionary(vertex => vertex.Id, vertex =>+ {+ var ring = source.Topology.Edges.FirstOrDefault(edge => edge.StartVertexId == vertex.Id+ && source.GetEdgeCurve(edge.Id).Kind == CurveGeometryKind.Circle3);+ source.TryGetVertexPoint(vertex.Id, out var point);+ return ring is null ? point : source.GetEdgeCurve(ring.Id).Circle3!.Value.Evaluate(seamAngle);+ });+ var perturbed = new BrepBody(source.Topology, source.Geometry, source.Bindings, points);+ var exported = Step242Exporter.ExportBody(perturbed);+ Assert.True(exported.IsSuccess, string.Join(" | ", exported.Diagnostics.Select(d => d.Message)));+ var imported = Step242Importer.ImportBody(exported.Value);+ Assert.True(imported.IsSuccess, string.Join(" | ", imported.Diagnostics.Select(d => d.Message)));+ var evidence = BrepPcurveValidator.Validate(imported.Value, 1e-6d);+ Assert.True(evidence.IsValid, string.Join(" | ", evidence.Diagnostics));+ Assert.InRange(evidence.MaximumReconstructionDeviation, 0d, 1e-7d);+ Assert.Equal(source.Bindings.PcurveBindings.Count(), imported.Value.Bindings.PcurveBindings.Count());+ }+[Theory][InlineData(false)][InlineData(true)]diff --git a/Aetheris.Kernel.Core/Brep/BrepPcurveRecovery.cs b/Aetheris.Kernel.Core/Brep/BrepPcurveRecovery.csindex b8f272be..2134d997 100644--- a/Aetheris.Kernel.Core/Brep/BrepPcurveRecovery.cs+++ b/Aetheris.Kernel.Core/Brep/BrepPcurveRecovery.cs@@ -90,6 +90,8 @@ public static class BrepPcurveRecoveryprivate static (PcurveGeometry? Pcurve, double MaximumResidual, string? Diagnostic) Build(SurfaceGeometry surface, CurveGeometry curve, ParameterInterval interval, double tolerance, int samples){+ if (TryBuildIsoParametricPcurve(surface, curve, interval) is { } exact)+ return (exact, 0d, null);if (surface.Plane is { } plane){var start = PlaneUv(plane, EvaluateCurve(curve, interval.Start));@@ -341,6 +343,70 @@ public static class BrepPcurveRecoveryvar axial = d.Dot(torus.Axis.ToVector());return new(double.Atan2(y, x), double.Atan2(axial, double.Sqrt(x * x + y * y) - torus.MajorRadius));}+ // Recognize analytic isoparametric edges before the general inverse/fit path.+ // Geometry identities, rather than the import tolerance, establish this case.+ // Populate still independently validates the lifted curve over its full span.+ internal static PcurveGeometry? TryBuildIsoParametricPcurve(+ SurfaceGeometry surface, CurveGeometry curve, ParameterInterval interval)+ {+ const double angularRoundoff = 1e-12d;+ var span = interval.End - interval.Start;+ if (surface.Cylinder is { } cylinder)+ {+ var axis = cylinder.Axis.ToVector();+ var epsilon = 1e-12d * double.Max(1d, cylinder.Radius);+ if (curve.Line3 is { } generator+ && generator.Direction.ToVector().Cross(axis).Length <= angularRoundoff)+ {+ var offset = generator.Origin - cylinder.Origin;+ if (double.Abs((offset - axis * offset.Dot(axis)).Length - cylinder.Radius) > epsilon) return null;+ var start = CylinderUv(cylinder, generator.Evaluate(interval.Start));+ return PcurveGeometry.Line(interval, start,+ new(start.U, start.V + span * generator.Direction.ToVector().Dot(axis)));+ }+ if (curve.Circle3 is { } ring && ring.Normal.ToVector().Cross(axis).Length <= angularRoundoff)+ {+ var offset = ring.Center - cylinder.Origin;+ if ((offset - axis * offset.Dot(axis)).Length > epsilon+ || double.Abs(ring.Radius - cylinder.Radius) > epsilon) return null;+ var start = CylinderUv(cylinder, ring.Evaluate(interval.Start));+ return PcurveGeometry.Line(interval, start,+ new(start.U + span * double.CopySign(1d, ring.Normal.ToVector().Dot(axis)), start.V));+ }+ }+ if (surface.Torus is { } torus && torus.MajorRadius > torus.MinorRadius && curve.Circle3 is { } circle)+ {+ var axis = torus.Axis.ToVector();+ var normal = circle.Normal.ToVector();+ var offset = circle.Center - torus.Center;+ var epsilon = 1e-12d * double.Max(1d, torus.MajorRadius + torus.MinorRadius);+ var start = TorusUv(torus, circle.Evaluate(interval.Start));+ if (normal.Cross(axis).Length <= angularRoundoff)+ {+ // Constant minor angle: a circle about the torus axis.+ if ((offset - axis * offset.Dot(axis)).Length > epsilon+ || double.Abs(offset.Dot(axis) - torus.MinorRadius * double.Sin(start.V)) > epsilon+ || double.Abs(circle.Radius - torus.MajorRadius - torus.MinorRadius * double.Cos(start.V)) > epsilon) return null;+ return PcurveGeometry.Line(interval, start,+ new(start.U + span * double.CopySign(1d, normal.Dot(axis)), start.V));+ }+ if (double.Abs(normal.Dot(axis)) <= angularRoundoff+ && double.Abs(offset.Dot(axis)) <= epsilon+ && double.Abs(offset.Length - torus.MajorRadius) <= epsilon+ && double.Abs(normal.Dot(offset)) <= epsilon+ && double.Abs(circle.Radius - torus.MinorRadius) <= epsilon)+ {+ // Constant major angle: the generating circle in a radial plane.+ var radial = offset / torus.MajorRadius;+ var positiveTangent = radial * -double.Sin(start.V) + axis * double.Cos(start.V);+ var direction = circle.Tangent(interval.Start).Dot(positiveTangent);+ return PcurveGeometry.Line(interval, start,+ new(start.U, start.V + span * double.CopySign(1d, direction)));+ }+ }+ return null;+ }+private static (PcurveGeometry? Pcurve, double MaximumResidual, string? Diagnostic) BuildPeriodicAnalytic(SurfaceGeometry surface, CurveGeometry curve, ParameterInterval interval, double tolerance,Func<Point3D, SurfaceParameterPoint> inverse, bool unwrapV = false)diff --git a/Aetheris.Kernel.Core/Brep/Tessellation/SurfaceMeshIr.cs b/Aetheris.Kernel.Core/Brep/Tessellation/SurfaceMeshIr.csindex 9fcb34bd..b4be2e2b 100644--- a/Aetheris.Kernel.Core/Brep/Tessellation/SurfaceMeshIr.cs+++ b/Aetheris.Kernel.Core/Brep/Tessellation/SurfaceMeshIr.cs@@ -1992,7 +1992,10 @@ public static class SurfaceMeshIrTessellatorvar ac = (positions[a] - positions[c]).Length; var bd = (positions[b] - positions[d]).Length;var acValid = TriangleAreaMagnitude(positions[a], positions[b], positions[c]) > Epsilon && TriangleAreaMagnitude(positions[a], positions[c], positions[d]) > Epsilon;var bdValid = TriangleAreaMagnitude(positions[a], positions[b], positions[d]) > Epsilon && TriangleAreaMagnitude(positions[b], positions[c], positions[d]) > Epsilon;- if (acValid && (!bdValid || ac <= bd)) indices.AddRange([a, b, c, a, c, d]);+ // Symmetric ruled quads have equal diagonals. Ignore only rounding-scale+ // length differences so platform libm does not select a different split.+ var tieTolerance = 1e-12d * double.Max(1d, double.Max(ac, bd));+ if (acValid && (!bdValid || ac <= bd + tieTolerance)) indices.AddRange([a, b, c, a, c, d]);else indices.AddRange([a, b, d, b, c, d]);}diff --git a/Aetheris.Kernel.Core/Step242/Step242ExportOptions.cs b/Aetheris.Kernel.Core/Step242/Step242ExportOptions.csindex 9cdf8684..6fc1b37b 100644--- a/Aetheris.Kernel.Core/Step242/Step242ExportOptions.cs+++ b/Aetheris.Kernel.Core/Step242/Step242ExportOptions.cs@@ -54,7 +54,10 @@ public sealed class Step242ExportOptions/// <summary>Source-declared vertex tolerances for an imported topology, capped by its binder.</summary>public IReadOnlyDictionary<VertexId, double>? ImportedSourceVertexTolerancesMillimetres { get; init; }- /// <summary>Preserve a full circular edge's declared parameter interval as TRIMMED_CURVE.</summary>+ /// <summary>+ /// Retained for source compatibility; no effect. Advanced-face edges use their+ /// underlying CIRCLE, with vertices, sense and pcurves defining the boundary.+ /// </summary>public bool EmitFullCircleTrimmedCurves { get; init; }/// <summary>Emit qualified coedge pcurves; false leaves STEP trim binding to the importer.</summary>diff --git a/Aetheris.Kernel.Core/Step242/Step242Exporter.cs b/Aetheris.Kernel.Core/Step242/Step242Exporter.csindex db55a095..096041fa 100644--- a/Aetheris.Kernel.Core/Step242/Step242Exporter.cs+++ b/Aetheris.Kernel.Core/Step242/Step242Exporter.cs@@ -112,7 +112,7 @@ public static class Step242Exporter? writer.AddEntity("REPRESENTATION_CONTEXT", Step242TextWriter.String("2D"), Step242TextWriter.String("parameter space")): null;- var outerClosedShellId = BuildClosedShell(writer, body, model, shellRepresentation.OuterShellId, vertexPoints, cartesianPointIds, vertexPointIds, edgeCurveIds, orientedEdgeIds, lineIds, circleIds, bsplineIds, ellipseIds, hyperbolaIds, surfaceIds, advancedFaceIds, pcurveContextId, options.EmitFullCircleTrimmedCurves);+ var outerClosedShellId = BuildClosedShell(writer, body, model, shellRepresentation.OuterShellId, vertexPoints, cartesianPointIds, vertexPointIds, edgeCurveIds, orientedEdgeIds, lineIds, circleIds, bsplineIds, ellipseIds, hyperbolaIds, surfaceIds, advancedFaceIds, pcurveContextId);EmitAuxiliaryVertexPointForVertexlessAnalyticBody(writer, body, model);if (outerClosedShellId is null){@@ -129,7 +129,7 @@ public static class Step242Exportervar orientedVoidShellIds = new List<string>();foreach (var innerShellId in shellRepresentation.InnerShellIds.OrderBy(id => id.Value)){- var innerClosedShellId = BuildClosedShell(writer, body, model, innerShellId, vertexPoints, cartesianPointIds, vertexPointIds, edgeCurveIds, orientedEdgeIds, lineIds, circleIds, bsplineIds, ellipseIds, hyperbolaIds, surfaceIds, advancedFaceIds, pcurveContextId, options.EmitFullCircleTrimmedCurves);+ var innerClosedShellId = BuildClosedShell(writer, body, model, innerShellId, vertexPoints, cartesianPointIds, vertexPointIds, edgeCurveIds, orientedEdgeIds, lineIds, circleIds, bsplineIds, ellipseIds, hyperbolaIds, surfaceIds, advancedFaceIds, pcurveContextId);if (innerClosedShellId is null){return Failure($"Shell {innerShellId.Value} could not be exported.", $"Shell:{innerShellId.Value}");@@ -218,8 +218,7 @@ public static class Step242ExporterDictionary<EdgeId, string> hyperbolaIds,Dictionary<SurfaceGeometryId, string> surfaceIds,Dictionary<FaceId, string> advancedFaceIds,- string? pcurveContextId,- bool emitFullCircleTrimmedCurves)+ string? pcurveContextId){if (!model.TryGetShell(shellId, out var shell) || shell is null){@@ -295,7 +294,7 @@ public static class Step242Exporterif (!edgeCurveIds.TryGetValue(coedge.EdgeId, out var edgeCurveId)){- var edgeResult = BuildEdgeCurve(body, model, writer, coedge.EdgeId, vertexPoints, cartesianPointIds, vertexPointIds, lineIds, circleIds, bsplineIds, ellipseIds, hyperbolaIds, surfaceIds, pcurveContextId, emitFullCircleTrimmedCurves);+ var edgeResult = BuildEdgeCurve(body, model, writer, coedge.EdgeId, vertexPoints, cartesianPointIds, vertexPointIds, lineIds, circleIds, bsplineIds, ellipseIds, hyperbolaIds, surfaceIds, pcurveContextId);if (!edgeResult.IsSuccess){return null;@@ -937,8 +936,7 @@ public static class Step242ExporterIDictionary<EdgeId, string> ellipseIds,IDictionary<EdgeId, string> hyperbolaIds,IReadOnlyDictionary<SurfaceGeometryId, string> surfaceIds,- string? pcurveContextId,- bool emitFullCircleTrimmedCurves)+ string? pcurveContextId){var edge = model.GetEdge(edgeId);@@ -1034,23 +1032,10 @@ public static class Step242ExportercircleIds[edgeId] = circleId;}- // EDGE_CURVE endpoints alone do not disambiguate the minor and major arcs- // of a CIRCLE for all downstream CAD kernels. Preserve the actual bounded- // analytic edge, rather than relying on a viewer to infer it from a wire.- var trim = edgeBinding.TrimInterval.Value;- var isFullCircle = double.Abs((trim.End - trim.Start) - (2d * double.Pi)) <= 1e-12d;- // A qualified pcurve is parameter-bound. Reconstructing a full-circle- // seam from an approximate source vertex can change its angular origin- // even though the circle geometry is unchanged. Keep the native interval- // whenever face-local bindings depend on it.- var hasPcurves = pcurveContextId is not null- && body.Bindings.PcurveBindings.Any(binding => model.GetCoedge(binding.CoedgeId).EdgeId == edgeId);- geometryCurveId = isFullCircle && !emitFullCircleTrimmedCurves && !hasPcurves- ? circleId- : writer.AddEntity("TRIMMED_CURVE", "$", Step242TextWriter.Ref(circleId),- Step242TextWriter.List($"PARAMETER_VALUE({Step242TextWriter.Number(trim.Start)})"),- Step242TextWriter.List($"PARAMETER_VALUE({Step242TextWriter.Number(trim.End)})"),- Step242TextWriter.BooleanLogical(true), Step242TextWriter.Enum("PARAMETER"));+ // ADVANCED_FACE requires an admitted basis curve, not TRIMMED_CURVE.+ // Edge vertices and same_sense bound the arc; face-local pcurves+ // retain periodic trim information without wrapping the 3D basis.+ geometryCurveId = circleId;}else if (curve.Kind == CurveGeometryKind.BSpline3 && curve.BSpline3 is BSpline3Curve spline){@@ -1116,11 +1101,7 @@ public static class Step242ExporterhyperbolaIds[edgeId] = hyperbolaId;}- var trim = edgeBinding.TrimInterval.Value;- geometryCurveId = writer.AddEntity("TRIMMED_CURVE", "$", Step242TextWriter.Ref(hyperbolaId),- Step242TextWriter.List($"PARAMETER_VALUE({Step242TextWriter.Number(trim.Start)})"),- Step242TextWriter.List($"PARAMETER_VALUE({Step242TextWriter.Number(trim.End)})"),- Step242TextWriter.BooleanLogical(true), Step242TextWriter.Enum("PARAMETER"));+ geometryCurveId = hyperbolaId;}else{diff --git a/Aetheris.Kernel.Core/Step242/StepPcurveDecoder.cs b/Aetheris.Kernel.Core/Step242/StepPcurveDecoder.csindex 3712ccca..7f8083aa 100644--- a/Aetheris.Kernel.Core/Step242/StepPcurveDecoder.cs+++ b/Aetheris.Kernel.Core/Step242/StepPcurveDecoder.cs@@ -1,6 +1,7 @@using Aetheris.Kernel.Core.Brep;using Aetheris.Kernel.Core.Diagnostics;using Aetheris.Kernel.Core.Geometry;+using Aetheris.Kernel.Core.Geometry.Curves;using Aetheris.Kernel.Core.Math;using Aetheris.Kernel.Core.Results;@@ -30,6 +31,12 @@ internal static class StepPcurveDecoderif (surfaceCurve.Arguments.ElementAtOrDefault(2) is not Step242ListValue associated)return Failure<IReadOnlyList<ImportedStepPcurve>>("SURFACE_CURVE/SEAM_CURVE associated_geometry must be a list.", "Importer.Pcurve.AssociatedGeometry");+ if (surfaceCurve.Arguments.ElementAtOrDefault(1) is not Step242EntityReference basisReference)+ return Failure<IReadOnlyList<ImportedStepPcurve>>("SURFACE_CURVE/SEAM_CURVE must reference its 3D basis.", "Importer.Pcurve.Binding");+ var basis = document.TryGetEntity(basisReference.TargetId);+ if (!basis.IsSuccess) return KernelResult<IReadOnlyList<ImportedStepPcurve>>.Failure(basis.Diagnostics);+ var periodicBasis = basis.Value.Name is "CIRCLE" or "ELLIPSE";+var result = new List<ImportedStepPcurve>();foreach (var item in associated.Items){@@ -60,7 +67,8 @@ internal static class StepPcurveDecoderSystem.Globalization.CultureInfo.InvariantCulture, out var parsedTolerance)&& double.IsFinite(parsedTolerance) && parsedTolerance is > 0d and <= 0.1d)declaredTolerance = parsedTolerance;- result.Add(new ImportedStepPcurve(geometryResult.Value.Geometry, geometryResult.Value.SameSense,+ var geometry = periodicBasis ? AlignPeriodicPcurve(geometryResult.Value.Geometry, edgeDomain) : geometryResult.Value.Geometry;+ result.Add(new ImportedStepPcurve(geometry, geometryResult.Value.SameSense,pcurve.Id, curveResult.Value.Id, DescribeCurveType(curveResult.Value), supportReference.TargetId,declaredTolerance));}@@ -157,6 +165,32 @@ internal static class StepPcurveDecoderKernelResult<DecodedPcurveGeometry>.Success(new(geometry, sameSense));}+ private static PcurveGeometry AlignPeriodicPcurve(PcurveGeometry curve, ParameterInterval edgeDomain)+ {+ // A CIRCLE edge inferred from its vertices can unwrap across zero after+ // roundoff. Its conic pcurve must use the same period, otherwise Evaluate+ // clamps all samples to an endpoint. Shift by whole periods only; never+ // stretch a pcurve to conceal a genuinely different trim.+ var shift = double.Round((edgeDomain.Start - curve.Domain.Start) / double.Tau) * double.Tau;+ if (shift == 0d || double.Abs(curve.Domain.Start + shift - edgeDomain.Start) > 1e-8d+ || double.Abs(curve.Domain.End + shift - edgeDomain.End) > 1e-8d) return curve;+ var domain = new ParameterInterval(curve.Domain.Start + shift, curve.Domain.End + shift);+ if (curve.PolynomialCurve is { } spline)+ {+ var translated = new BSpline3Curve(spline.Degree, spline.ControlPoints, spline.KnotMultiplicities,+ spline.KnotValues.Select(value => value + shift).ToArray(), spline.CurveForm, spline.ClosedCurve, spline.SelfIntersect, spline.KnotSpec);+ return curve.RationalWeights is { } weights ? PcurveGeometry.RationalPolynomial(domain, translated, weights)+ : PcurveGeometry.Polynomial(domain, translated);+ }+ return curve.Kind switch+ {+ PcurveGeometryKind.Line => PcurveGeometry.Line(domain, curve.Points[0], curve.Points[1]),+ PcurveGeometryKind.Circle => PcurveGeometry.Circle(domain, curve.Points[0], curve.Points[1].U, curve.Points[1].V),+ PcurveGeometryKind.Ellipse => PcurveGeometry.Ellipse(domain, curve.Points[0], curve.Points[1], curve.Points[2]),+ _ => PcurveGeometry.Polyline(domain, curve.Points),+ };+ }+private static KernelResult<PcurveGeometry> DecodeConic(Step242ParsedDocument document, Step242EntityConstructor conic, ParameterInterval domain, bool circle){if (conic.Arguments.ElementAtOrDefault(1) is not Step242EntityReference placementReferencediff --git a/Aetheris.Kernel.Firmament.Tests/FirmamentV2StandaloneCubicLatticeTests.cs b/Aetheris.Kernel.Firmament.Tests/FirmamentV2StandaloneCubicLatticeTests.csindex 37fd187f..1ef99fb0 100644--- a/Aetheris.Kernel.Firmament.Tests/FirmamentV2StandaloneCubicLatticeTests.cs+++ b/Aetheris.Kernel.Firmament.Tests/FirmamentV2StandaloneCubicLatticeTests.cs@@ -42,7 +42,7 @@ public sealed class FirmamentV2StandaloneCubicLatticeTestsAssert.Equal(lattice.AnalyticVolume, lattice.BrepVolume, 8);Assert.Contains("SPHERICAL_SURFACE", build.Value.Export.StepText, StringComparison.Ordinal);Assert.Contains("CYLINDRICAL_SURFACE", build.Value.Export.StepText, StringComparison.Ordinal);- Assert.Contains("TRIMMED_CURVE", build.Value.Export.StepText, StringComparison.Ordinal);+ Assert.Contains("CIRCLE", build.Value.Export.StepText, StringComparison.Ordinal);Assert.True(Step242Importer.ImportBody(build.Value.Export.StepText).IsSuccess);}finallydiff --git a/Aetheris.Kernel.Firmament.Tests/WireFormTests.cs b/Aetheris.Kernel.Firmament.Tests/WireFormTests.csindex 4feeff12..120dfe6c 100644--- a/Aetheris.Kernel.Firmament.Tests/WireFormTests.cs+++ b/Aetheris.Kernel.Firmament.Tests/WireFormTests.cs@@ -2,11 +2,117 @@ using Aetheris.Kernel.Core.Step242;using Aetheris.Kernel.Firmament.FirmamentV2;using Aetheris.Kernel.Firmament.Materializer;using Aetheris.Kernel.Core.Math;+using Aetheris.Kernel.Core.Geometry;+using Aetheris.Kernel.Core.Brep;namespace Aetheris.Kernel.Firmament.Tests;public sealed class WireFormTests{+ [Fact]+ public void PaperclipImportExport_PreservesAnalyticGeometryWithoutFittedUvSplines()+ {+ var compiled = FirmamentBuildAndExport.CompileSource(File.ReadAllText(Fixture("Canonical", "WireForm", "paperclip.firmament")));+ Assert.True(compiled.IsSuccess, string.Join("; ", compiled.Diagnostics.Select(d => d.Message)));+ var step = compiled.Value.StepText;+ for (var roundtrip = 0; roundtrip < 2; roundtrip++)+ {+ // The source is generated here: exercise recovery, not a cached import.+ var imported = Step242Importer.ImportBody(step);+ Assert.True(imported.IsSuccess, string.Join("; ", imported.Diagnostics.Select(d => d.Message)));+ var body = imported.Value;+ Assert.Equal(9, body.Topology.Faces.Count());+ Assert.Equal(15, body.Topology.Edges.Count());+ Assert.Equal(8, body.Topology.Vertices.Count());+ Assert.Equal(3, body.Geometry.Surfaces.Count(s => s.Value.Kind == SurfaceGeometryKind.Torus));+ Assert.Equal(4, body.Geometry.Surfaces.Count(s => s.Value.Kind == SurfaceGeometryKind.Cylinder));+ Assert.Equal(30, body.Bindings.PcurveBindings.Count());+ foreach (var binding in body.Bindings.PcurveBindings)+ {+ Assert.Null(binding.Pcurve.PolynomialCurve);+ if (body.GetFaceSurface(binding.FaceId).Kind is SurfaceGeometryKind.Cylinder or SurfaceGeometryKind.Torus)+ Assert.Equal(PcurveGeometryKind.Line, binding.Pcurve.Kind);+ }+ var evidence = BrepPcurveValidator.Validate(body, 1e-9, requireEveryCoedge: true);+ Assert.True(evidence.IsValid, string.Join("; ", evidence.Diagnostics));+ Assert.True(evidence.MaximumReconstructionDeviation < 1e-10);+ var exported = Step242Exporter.ExportBody(body);+ Assert.True(exported.IsSuccess);+ step = exported.Value;+ Assert.DoesNotContain("B_SPLINE", step, StringComparison.Ordinal);+ Assert.DoesNotContain("POLYLINE", step, StringComparison.Ordinal);+ Assert.Contains("SEAM_CURVE", step, StringComparison.Ordinal);+ Assert.True(step.Length < 20_000, "Analytic paperclip trims must retain a bounded compact representation.");+ }+ }++ [Theory]+ [InlineData("straight-wire.firmament")]+ [InlineData("u-wire.firmament")]+ [InlineData("paperclip.firmament")]+ [InlineData("three-dimensional-bends.firmament")]+ public void ExactSweep_BoundariesAgreeWithOutwardNormalsBeforeAnyImport(string fixture)+ {+ var parsed = WireFormAuthoring.Parse(File.ReadAllText(Fixture("Canonical", "WireForm", fixture)));+ Assert.True(parsed.IsSuccess, string.Join(" | ", parsed.Diagnostics.Select(d => d.Message)));+ var built = WireFormBRepMaterializer.Build(parsed.Value);+ Assert.True(built.IsSuccess, string.Join(" | ", built.Diagnostics.Select(d => d.Message)));+ var body = built.Value.Body;+ foreach (var face in body.Topology.Faces)+ {+ var surface = body.GetFaceSurface(face.Id);+ var uses = face.LoopIds.SelectMany(id => body.Topology.GetLoop(id).CoedgeIds)+ .Select(body.Topology.GetCoedge).ToArray();+ foreach (var use in uses.Where(use => body.GetEdgeCurve(use.EdgeId).Kind == CurveGeometryKind.Circle3+ && body.Topology.GetEdge(use.EdgeId).StartVertexId == body.Topology.GetEdge(use.EdgeId).EndVertexId))+ {+ var circle = body.GetEdgeCurve(use.EdgeId).Circle3!.Value;+ var sense = (use.IsReversed ? -1d : 1d)+ * (body.Bindings.GetEdgeBinding(use.EdgeId).OrientedEdgeSense ? 1d : -1d);+ if (surface.Plane is { } plane)+ {+ Assert.True(circle.Normal.ToVector().Dot(plane.Normal.ToVector()) * sense > .999999,+ $"{fixture}, cap {face.Id}: boundary must turn about its outward normal.");+ continue;+ }+ // At either end ring, n x boundary-tangent must point along the+ // centerline into this segment, rather than into its neighbor.+ var operation = parsed.Value.Operations[face.Id.Value - 1];+ var atStart = (circle.Center - operation.Input.Position).Length < 1e-8;+ var inward = atStart ? operation.Input.Tangent.ToVector() : operation.Output.Tangent.ToVector() * -1d;+ var point = circle.Evaluate(.73);+ var normal = (point - circle.Center) / circle.Radius;+ Assert.True(normal.Cross(circle.Tangent(.73) * sense).Dot(inward) > 0d,+ $"{fixture}, side {face.Id}: boundary must have the face interior to its left.");+ }+ }++ var step = Step242Exporter.ExportBody(body);+ Assert.True(step.IsSuccess);+ var document = Step242SubsetParser.Parse(step.Value).Value;+ foreach (var face in document.Entities.Where(e => e.Name == "ADVANCED_FACE"))+ {+ var supportId = Step242SubsetDecoder.ReadReference(face, 2, "face surface").Value.TargetId;+ var support = document.Entities.Single(e => e.Id == supportId);+ if (support.Name != "PLANE") continue;+ var plane = Step242SubsetDecoder.ReadPlaneSurface(document, support).Value;+ var boundId = Assert.Single(Step242SubsetDecoder.ReadReferenceList(face, 1, "face bounds").Value).TargetId;+ var bound = document.Entities.Single(e => e.Id == boundId);+ var loopId = Step242SubsetDecoder.ReadReference(bound, 1, "bound loop").Value.TargetId;+ var loop = document.Entities.Single(e => e.Id == loopId);+ var useId = Assert.Single(Step242SubsetDecoder.ReadReferenceList(loop, 1, "loop uses").Value).TargetId;+ var use = document.Entities.Single(e => e.Id == useId);+ var edgeId = Step242SubsetDecoder.ReadReference(use, 3, "oriented edge").Value.TargetId;+ var edge = document.Entities.Single(e => e.Id == edgeId);+ var curveId = Step242SubsetDecoder.ReadReference(edge, 3, "edge basis").Value.TargetId;+ var circle = Step242SubsetDecoder.ReadCircleCurve(document, document.Entities.Single(e => e.Id == curveId)).Value;+ var sign = new[] { (face, 3), (bound, 2), (use, 4), (edge, 4) }+ .Aggregate(1d, (s, item) => s * (Step242SubsetDecoder.ReadBoolean(item.Item1, item.Item2, "orientation").Value ? 1d : -1d));+ Assert.True(circle.Normal.ToVector().Dot(plane.Normal.ToVector()) * sign > .999999);+ }+ Assert.DoesNotContain("TRIMMED_CURVE", step.Value, StringComparison.Ordinal);+ }+[Fact]public void CommentedOperationsDoNotCreateGeometryOrProvenance(){diff --git a/Aetheris.Kernel.Firmament/FirmamentBuildAndExport.cs b/Aetheris.Kernel.Firmament/FirmamentBuildAndExport.csindex 5f541807..ddf3bbac 100644--- a/Aetheris.Kernel.Firmament/FirmamentBuildAndExport.cs+++ b/Aetheris.Kernel.Firmament/FirmamentBuildAndExport.cs@@ -1355,7 +1355,6 @@ public static partial class FirmamentBuildAndExportApplicationName = "Aetheris.Firmament.CubicTruss.M9R",BrepExportPreflightMode = BrepExportPreflightMode.Enforce,BrepExportPreflightPolicy = BrepExportPreflightPolicy.TrustedProductionRoute,- EmitFullCircleTrimmedCurves = true,});if (!step.IsSuccess || step.Value is null) return KernelResult<FirmamentStepExportResult>.Failure(step.Diagnostics);var reimport = Step242Importer.ImportBody(step.Value);diff --git a/Aetheris.Kernel.Firmament/Materializer/WireForm.cs b/Aetheris.Kernel.Firmament/Materializer/WireForm.csindex 179fe700..393c990a 100644--- a/Aetheris.Kernel.Firmament/Materializer/WireForm.cs+++ b/Aetheris.Kernel.Firmament/Materializer/WireForm.cs@@ -408,15 +408,17 @@ public static class WireFormBRepMaterializergeometry.AddSurface(surface, SurfaceGeometry.FromTorus(new TorusSurface(bend.Center, bend.PlaneNormal, bend.RadiusMm, feature.WireRadiusMm, bend.StartRadial)));}else throw new NotSupportedException("WireForm X0 admits Straight and Bend only.");- var side = AddFace(builder, [(seam, false), (ringEdges[i + 1], false), (seam, true), (ringEdges[i], true)]);+ // Walk the boundary with the face interior to the left of its+ // outward analytic normal (including both uses of the seam).+ var side = AddFace(builder, [(ringEdges[i], false), (seam, false), (ringEdges[i + 1], true), (seam, true)]);bindings.AddFaceBinding(new(side, surface)); faces.Add(side);}var startSurface = new SurfaceGeometryId(nextSurface++);geometry.AddSurface(startSurface, SurfaceGeometry.FromPlane(new PlaneSurface(feature.StartState.Position, Direction3D.Create(feature.StartState.Tangent.ToVector() * -1d), feature.StartState.Up)));- var startFace = AddFace(builder, [(ringEdges[0], false)]); bindings.AddFaceBinding(new(startFace, startSurface)); faces.Add(startFace);+ var startFace = AddFace(builder, [(ringEdges[0], true)]); bindings.AddFaceBinding(new(startFace, startSurface)); faces.Add(startFace);var endSurface = new SurfaceGeometryId(nextSurface++);geometry.AddSurface(endSurface, SurfaceGeometry.FromPlane(new PlaneSurface(feature.EndState.Position, feature.EndState.Tangent, feature.EndState.Up)));- var endFace = AddFace(builder, [(ringEdges[^1], true)]); bindings.AddFaceBinding(new(endFace, endSurface)); faces.Add(endFace);+ var endFace = AddFace(builder, [(ringEdges[^1], false)]); bindings.AddFaceBinding(new(endFace, endSurface)); faces.Add(endFace);var shell = builder.AddShell(faces); builder.AddBody([shell]); var body = new BrepBody(builder.Model, geometry, bindings, vertexPoints);var bindingValidation = BrepBindingValidator.Validate(body, true);if (!bindingValidation.IsSuccess) return KernelResult<WireFormBuildResult>.Failure(bindingValidation.Diagnostics);diff --git a/Aetheris.Server.Tests/CadmataStartupTests.cs b/Aetheris.Server.Tests/CadmataStartupTests.csindex dcf6d115..2ccf499a 100644--- a/Aetheris.Server.Tests/CadmataStartupTests.cs+++ b/Aetheris.Server.Tests/CadmataStartupTests.cs@@ -11,6 +11,24 @@ namespace Aetheris.Server.Tests;public sealed class CadmataStartupTests{+ [Fact]+ public void NoArguments_LeavesTheWorkspaceBlank()+ => Assert.Null(CadmataLaunchOptions.Parse([]).Step);++ [Fact]+ public async Task BrowserHost_NoArgumentsBindsOnlyAnEphemeralLoopbackPort()+ {+ await using var app = CadmataApplication.Create([], CadmataLaunchOptions.Parse([]));+ await app.StartAsync();+ try+ {+ var address = Assert.Single(app.Urls);+ Assert.StartsWith("http://127.0.0.1:", address);+ Assert.DoesNotContain(":0", address);+ }+ finally { await app.StopAsync(); }+ }+[Theory][InlineData(true)][InlineData(false)]@@ -126,7 +144,9 @@ public sealed class CadmataStartupTestsFile.WriteAllText(Path.Combine(directory, "wwwroot", "index.html"), "<!doctype html>");options.ValidateProductionAssets(directory);- new CadmataLaunchOptions(null, false, false).ValidateProductionAssets(Path.Combine(directory, "missing"));+ Assert.Throws<CadmataLaunchException>(() =>+ new CadmataLaunchOptions(null, false, false).ValidateProductionAssets(Path.Combine(directory, "missing")));+ new CadmataLaunchOptions(null, true, false).ValidateProductionAssets(Path.Combine(directory, "missing"));}finally{diff --git a/Aetheris.Server.Tests/ModelingDemoTests.cs b/Aetheris.Server.Tests/ModelingDemoTests.csnew file mode 100644index 00000000..5d14aea1--- /dev/null+++ b/Aetheris.Server.Tests/ModelingDemoTests.cs@@ -0,0 +1,39 @@+using System.Net.Http.Json;+using Aetheris.Server.Api;+using Aetheris.Server.Contracts;+using Aetheris.Kernel.Core.Step242;+using Microsoft.AspNetCore.Mvc.Testing;++namespace Aetheris.Server.Tests;++public sealed class ModelingDemoTests(WebApplicationFactory<Program> factory) : IClassFixture<WebApplicationFactory<Program>>+{+ [Fact]+ public async Task ComposedBlocks_UseSectionPlanningAndExportOneEnclosedSolid()+ {+ using var client = factory.CreateClient();+ var response = await client.PostAsJsonAsync("/api/v1/demos/composed-block", new ComposedBlockRequest(80, 50, 8, 30, 20, 12));+ Assert.True(response.IsSuccessStatusCode, await response.Content.ReadAsStringAsync());+ var built = (await response.Content.ReadFromJsonAsync<ApiResponseDto<ComposedBlockResponse>>())!.Data!;+ Assert.Equal("PrismaticSectionStack/Add", built.MaterializationRoute);+ Assert.Equal("composed-block.step", built.ExportPath);+ var imported = Step242Importer.ImportBody(built.StepText);+ Assert.True(imported.IsSuccess);+ Assert.Single(imported.Value.Topology.Bodies);+ Assert.True(Assert.Single(imported.Value.ImportQualification!.Shells).Enclosed);+ var points = imported.Value.Topology.Vertices.Select(vertex => {+ Assert.True(imported.Value.TryGetVertexPoint(vertex.Id, out var point)); return point;+ }).ToArray();+ Assert.Equal(-40, points.Min(p => p.X), 7); Assert.Equal(40, points.Max(p => p.X), 7);+ Assert.Equal(0, points.Min(p => p.Z), 7); Assert.Equal(20, points.Max(p => p.Z), 7);+ }++ [Fact]+ public async Task ComposedBlocks_RejectInvalidDimensions()+ {+ using var client = factory.CreateClient();+ var response = await client.PostAsJsonAsync("/api/v1/demos/composed-block", new ComposedBlockRequest(10, 10, 8, 30, 20, 12));+ Assert.False(response.IsSuccessStatusCode);+ Assert.Contains("fit within the base", await response.Content.ReadAsStringAsync());+ }+}diff --git a/Aetheris.Server.Tests/StandardProductGalleryIntegrationTests.cs b/Aetheris.Server.Tests/StandardProductGalleryIntegrationTests.csindex fc124d41..913fe188 100644--- a/Aetheris.Server.Tests/StandardProductGalleryIntegrationTests.cs+++ b/Aetheris.Server.Tests/StandardProductGalleryIntegrationTests.cs@@ -29,13 +29,16 @@ public sealed class StandardProductGalleryIntegrationTests : IClassFixture<WebAp["material"] = "Standard.Materials.Aluminum.6061_T6",};var request = new GalleryInvocationRequest(values.ToDictionary(pair => pair.Key,- pair => JsonSerializer.SerializeToElement(pair.Value), StringComparer.Ordinal), [ForgeArtifactKind.StepAp242]);+ pair => JsonSerializer.SerializeToElement(pair.Value), StringComparer.Ordinal), [ForgeArtifactKind.StepAp242], "products/mounting-plate.step");var response = await client.PostAsJsonAsync("/api/v1/gallery/templates/Standard.Products.Mechanical.MountingPlate", request);response.EnsureSuccessStatusCode();+ using var wire = JsonDocument.Parse(await response.Content.ReadAsStringAsync());+ Assert.Equal("StepAp242", wire.RootElement.GetProperty("data").GetProperty("artifacts")[0].GetProperty("kind").GetString());var envelope = await response.Content.ReadFromJsonAsync<ApiResponseDto<GalleryInvocationResponse>>();var artifact = Assert.Single(envelope!.Data!.Artifacts);Assert.Contains("ISO-10303-21", artifact.Content, StringComparison.Ordinal);Assert.Equal("part.step", artifact.Name);+ Assert.Equal("products/mounting-plate.step", artifact.ExportPath);}[Fact]diff --git a/Aetheris.Server/Aetheris.Server.csproj b/Aetheris.Server/Aetheris.Server.csprojindex 98380789..467b94db 100644--- a/Aetheris.Server/Aetheris.Server.csproj+++ b/Aetheris.Server/Aetheris.Server.csproj@@ -1,7 +1,7 @@<Project Sdk="Microsoft.NET.Sdk.Web"><PropertyGroup>- <OutputType>WinExe</OutputType>+ <OutputType>Exe</OutputType><TargetFramework>net10.0</TargetFramework><Nullable>enable</Nullable><ImplicitUsings>enable</ImplicitUsings>diff --git a/Aetheris.Server/Api/ModelingDemoEndpoints.cs b/Aetheris.Server/Api/ModelingDemoEndpoints.csnew file mode 100644index 00000000..1f6f9868--- /dev/null+++ b/Aetheris.Server/Api/ModelingDemoEndpoints.cs@@ -0,0 +1,44 @@+using System.Globalization;+using Aetheris.Kernel.Firmament;++namespace Aetheris.Server.Api;++public sealed record ComposedBlockRequest(double Width, double Depth, double Height,+ double PadWidth, double PadDepth, double PadHeight);+public sealed record ComposedBlockResponse(string StepText, string ExportPath, string Source, string MaterializationRoute);++public static class ModelingDemoEndpoints+{+ public static void MapModelingDemoApi(this WebApplication app)+ {+ app.MapPost("/api/v1/demos/composed-block", (ComposedBlockRequest request) =>+ {+ var dimensions = new[] { request.Width, request.Depth, request.Height, request.PadWidth, request.PadDepth, request.PadHeight };+ if (dimensions.Any(value => !double.IsFinite(value) || value <= 0)+ || request.PadWidth > request.Width || request.PadDepth > request.Depth)+ return ApiMappings.BadRequestFromMessage("Dimensions must be positive; the raised block must fit within the base footprint.", "modeling-demo.dimensions");+ var source = $$"""+ Model ComposedBlock {+ units: mm+ Concept Struct Layout on XY {+ Rect2 Stock { center: [0mm, 0mm]; size: [{{Mm(request.Width)}}, {{Mm(request.Depth)}}] }+ Rect2 Pad { center: [0mm, 0mm]; size: [{{Mm(request.PadWidth)}}, {{Mm(request.PadDepth)}}] }+ }+ Profile BaseProfile using Layout { Loop Outer { Stock.Bottom |> Stock.Right |> Stock.Top |> Stock.Left |> Close } }+ Profile PadProfile using Layout { Loop Outer { Pad.Bottom |> Pad.Right |> Pad.Top |> Pad.Left |> Close } }+ Compose Body {+ Base Stock { profile: BaseProfile; from: 0mm; to: {{Mm(request.Height)}}; role: Stock }+ Boss RaisedBlock { on: Top; profile: PadProfile; height: {{Mm(request.PadHeight)}} }+ }+ }+ """;+ var compiled = FirmamentBuildAndExport.CompileSource(source);+ if (!compiled.IsSuccess) return ApiMappings.KernelFailure(compiled.Diagnostics);+ var route = compiled.Value.EngineeringFeatures?.SingleOrDefault(feature => feature.Name == "RaisedBlock")?.MaterializationRoute;+ if (route is null) return ApiMappings.BadRequestFromMessage("The composed block has no materialization receipt.", "modeling-demo.compile");+ return ApiMappings.Ok(new ComposedBlockResponse(compiled.Value.StepText, "composed-block.step", source, route));+ });+ }++ private static string Mm(double value) => value.ToString("R", CultureInfo.InvariantCulture) + "mm";+}diff --git a/Aetheris.Server/Api/StandardProductGalleryEndpoints.cs b/Aetheris.Server/Api/StandardProductGalleryEndpoints.csindex 3ead6730..314c6167 100644--- a/Aetheris.Server/Api/StandardProductGalleryEndpoints.cs+++ b/Aetheris.Server/Api/StandardProductGalleryEndpoints.cs@@ -6,7 +6,8 @@ namespace Aetheris.Server.Api;public sealed record GalleryInvocationRequest(IReadOnlyDictionary<string, JsonElement>? Arguments,- IReadOnlyList<ForgeArtifactKind>? Artifacts);+ IReadOnlyList<ForgeArtifactKind>? Artifacts,+ string? ExportPath = null);public sealed record GalleryArtifactContent(ForgeArtifactKind Kind,@@ -14,7 +15,8 @@ public sealed record GalleryArtifactContent(string ContentType,long Size,string Sha256,- string Content);+ string Content,+ string? ExportPath = null);public sealed record GalleryInvocationResponse(bool Success,@@ -40,6 +42,9 @@ public static class StandardProductGalleryEndpointsapp.MapPost("/api/v1/gallery/templates/{**templateId}", (string templateId, GalleryInvocationRequest request) =>{+ if (request.ExportPath is { } requested && (string.IsNullOrWhiteSpace(requested)+ || !(requested.EndsWith(".step", StringComparison.OrdinalIgnoreCase) || requested.EndsWith(".stp", StringComparison.OrdinalIgnoreCase))))+ return ApiMappings.BadRequestFromMessage("The STEP export path must end in .step or .stp. It is a download name, not a server filesystem destination.", "gallery.exportPath");var output = Path.Combine(Path.GetTempPath(), "aetheris-gallery-" + Guid.NewGuid().ToString("N"));try{@@ -49,7 +54,7 @@ public static class StandardProductGalleryEndpoints{var path = Path.Combine(output, artifact.Path);return new GalleryArtifactContent(artifact.Kind, artifact.Name, artifact.ContentType,- artifact.Size, artifact.Sha256, File.ReadAllText(path));+ artifact.Size, artifact.Sha256, File.ReadAllText(path), artifact.Kind == ForgeArtifactKind.StepAp242 ? request.ExportPath ?? artifact.Path : artifact.Path);}).ToArray();var response = new GalleryInvocationResponse(result.Success, result.Identity, result.Diagnostics,artifacts, result.ExecutionMilliseconds);diff --git a/Aetheris.Server/Program.cs b/Aetheris.Server/Program.csindex 97c0f991..3d8ba1eb 100644--- a/Aetheris.Server/Program.cs+++ b/Aetheris.Server/Program.cs@@ -6,12 +6,18 @@ using Microsoft.AspNetCore.Hosting.Server;using Microsoft.AspNetCore.Hosting.Server.Features;using Microsoft.AspNetCore.StaticFiles;using System.Diagnostics;+using System.Reflection;+using System.Security.Cryptography;++// An embedded host (including WebApplicationFactory) owns its own presentation+// and lifetime. Only the real executable launches a browser window.+var ownsProcess = Assembly.GetEntryAssembly() == typeof(Program).Assembly;CadmataLaunchOptions launchOptions;try{launchOptions = CadmataLaunchOptions.Parse(args);- launchOptions.ValidateProductionAssets(AppContext.BaseDirectory);+ if (ownsProcess) launchOptions.ValidateProductionAssets(AppContext.BaseDirectory);}catch (CadmataLaunchException exception){@@ -19,9 +25,10 @@ catch (CadmataLaunchException exception)return 2;}-var app = CadmataApplication.Create(args, launchOptions);--if (launchOptions.Step is null)+var browserSession = ownsProcess && !launchOptions.NoBrowser && !launchOptions.HasExplicitUrls;+var sessionToken = browserSession ? Convert.ToHexString(RandomNumberGenerator.GetBytes(32)) : null;+var app = CadmataApplication.Create(args, launchOptions, sessionToken: sessionToken);+if (!ownsProcess){app.Run();return 0;@@ -35,13 +42,15 @@ var address = addresses?.FirstOrDefault(static value => value.StartsWith("http:/?? throw new InvalidOperationException("Cadmata started without a browser address.");Console.WriteLine($"Cadmata ready: {address}");-Console.WriteLine($"Opening: {launchOptions.Step.Path}");+if (launchOptions.Step is not null) Console.WriteLine($"Opening: {launchOptions.Step.Path}");+if (ownsProcess) Console.WriteLine("Close this server window or press Ctrl+C to end the Cadmata session.");-if (!launchOptions.NoBrowser)+if (ownsProcess && !launchOptions.NoBrowser){try{- Process.Start(new ProcessStartInfo(address) { UseShellExecute = true });+ var browserAddress = sessionToken is null ? address : address + "/__cadmata/session/" + sessionToken;+ Process.Start(new ProcessStartInfo(browserAddress) { UseShellExecute = true });}catch (Exception exception){diff --git a/Aetheris.Server/Startup/CadmataApplication.cs b/Aetheris.Server/Startup/CadmataApplication.csindex 49765518..710b96e1 100644--- a/Aetheris.Server/Startup/CadmataApplication.cs+++ b/Aetheris.Server/Startup/CadmataApplication.cs@@ -18,7 +18,7 @@ public static class CadmataApplicationContentRootPath = AppContext.BaseDirectory,});- if (!portable && launchOptions.Step is not null && !launchOptions.HasExplicitUrls)+ if (!portable && !launchOptions.HasExplicitUrls){builder.WebHost.UseUrls("http://127.0.0.1:0");}@@ -65,6 +65,7 @@ public static class CadmataApplicationapp.MapKernelApi();app.MapCadmataStartupApi();app.MapPaperclipDemoApi();+ app.MapModelingDemoApi();app.MapStandardProductGalleryApi();app.UseDefaultFiles();diff --git a/Aetheris.Server/Startup/CadmataLaunchOptions.cs b/Aetheris.Server/Startup/CadmataLaunchOptions.csindex ffa8edb2..92e9a193 100644--- a/Aetheris.Server/Startup/CadmataLaunchOptions.cs+++ b/Aetheris.Server/Startup/CadmataLaunchOptions.cs@@ -8,7 +8,7 @@ public sealed record CadmataLaunchOptions(CadmataStartupStepContent? Step, bool{public void ValidateProductionAssets(string applicationDirectory){- if (Step is null)+ if (Step is null && NoBrowser){return;}diff --git a/Aetheris.Web.Runtime/telos/src/camera.ts b/Aetheris.Web.Runtime/telos/src/camera.tsindex 7b23ddb9..3be6b914 100644--- a/Aetheris.Web.Runtime/telos/src/camera.ts+++ b/Aetheris.Web.Runtime/telos/src/camera.ts@@ -72,6 +72,22 @@ export class TelosCamera {this.fov = value.fovDegrees;this.update();}+ /** Tumble the viewing frame together with the eye; poles are ordinary orientations. */+ orbit(yaw: number, pitch: number) {+ const offset = this.position.clone().sub(this.target);+ offset.applyAxisAngle(this.up.clone().normalize(), yaw);+ const right = new Vector3().crossVectors(offset, this.up).normalize();+ offset.applyAxisAngle(right, pitch);+ this.up.applyAxisAngle(right, pitch).normalize();+ this.position.copy(this.target).add(offset);+ this.update();+ }+ orient(direction: NumericArray, up: NumericArray) {+ const distance = this.position.distanceTo(this.target);+ this.position.copy(this.target).add(new Vector3(direction[0], direction[1], direction[2]).normalize().multiplyScalar(distance));+ this.up.set(up[0], up[1], up[2]).normalize();+ this.update();+ }update() {if (!(this.near > 0 && this.far > this.near && this.span > 0))throw new Error("telos-camera-clipping-invalid");@@ -129,6 +145,7 @@ export class TelosCamera {return { origin, direction: end.clone().sub(origin).normalize() };}fit(minimum: NumericArray, maximum: NumericArray) {+ const direction = this.position.clone().sub(this.target).normalize();const min = new Vector3(minimum[0], minimum[1], minimum[2]),max = new Vector3(maximum[0], maximum[1], maximum[2]);if (@@ -142,11 +159,7 @@ export class TelosCamera {Math.tan((this.fov * Math.PI) / 360) * Math.min(1, aspect),);const distance = (radius / Math.sin(halfAngle)) * 1.15;- // Respect each product's world-up convention instead of imposing a Y-up view.- const direction =- Math.abs(this.up.z) > 0.5- ? new Vector3(1, -1, 0.8)- : new Vector3(1, 0.8, 1);+ // Fit changes framing, not the user's orientation or the viewing-frame up.this.position.copy(this.target).add(direction.normalize().multiplyScalar(distance));diff --git a/Aetheris.Web.Runtime/telos/src/navigation.ts b/Aetheris.Web.Runtime/telos/src/navigation.tsindex aea36bd5..e053a396 100644--- a/Aetheris.Web.Runtime/telos/src/navigation.ts+++ b/Aetheris.Web.Runtime/telos/src/navigation.ts@@ -1,4 +1,4 @@-import { Vector3, Quaternion } from "three";+import { Vector3 } from "three";import type { TelosCamera } from "./camera.js";/** Inputs change Telos state directly, rather than copying authoritative camera state from controls. */@@ -20,19 +20,7 @@ export function attachNavigation(drag.y = event.clientY;const offset = camera.position.clone().sub(camera.target);if (drag.button === 0 && !event.shiftKey) {- offset.applyQuaternion(- new Quaternion().setFromAxisAngle(- camera.up.clone().normalize(),- -dx * 0.006,- ),- );- const right = new Vector3().crossVectors(offset, camera.up).normalize();- const next = offset- .clone()- .applyQuaternion(new Quaternion().setFromAxisAngle(right, -dy * 0.006));- if (Math.abs(next.clone().normalize().dot(camera.up)) < 0.995)- offset.copy(next);- camera.position.copy(camera.target).add(offset);+ camera.orbit(-dx * 0.006, -dy * 0.006);} else {const scale =(camera.mode === "orthographic"diff --git a/Aetheris.Web.Runtime/telos/tests/camera.test.ts b/Aetheris.Web.Runtime/telos/tests/camera.test.tsindex 4a43647c..2ee84866 100644--- a/Aetheris.Web.Runtime/telos/tests/camera.test.ts+++ b/Aetheris.Web.Runtime/telos/tests/camera.test.ts@@ -9,6 +9,28 @@ import {} from "../dist/index.js";import type { TelosScene } from "../dist/index.js";+test("orbit crosses both world poles without a guard, singularity or lost pan basis", () => {+ const camera = new TelosCamera();+ camera.position.set(0, -10, 0); camera.target.set(0, 0, 0); camera.up.set(0, 0, 1); camera.update();+ for (let quarter = 0; quarter < 4; quarter++) {+ for (let step = 0; step < 90; step++) camera.orbit(0, Math.PI / 180);+ assert(Math.abs(camera.position.length() - 10) < 1e-10);+ assert(camera.viewProjection.elements.every(Number.isFinite));+ assert(new Vector3().setFromMatrixColumn(camera.inverseView, 0).length() > .999);+ if (quarter % 2 === 0) assert(Math.abs(camera.position.z) > 9.999);+ }+ assert(camera.position.distanceTo(new Vector3(0, -10, 0)) < 1e-10);+ for (const [direction, up] of [[[0,0,1],[0,1,0]], [[0,0,-1],[0,-1,0]]]) {+ camera.orient(direction, up);+ assert(Math.abs(camera.position.z) > 9.999);+ assert.deepEqual(camera.project([0,0,0]).slice(0,2), [.5,.5]);+ camera.fit([-5, -3, 0], [5, 3, 2]);+ assert(camera.position.clone().sub(camera.target).normalize().distanceTo(new Vector3(...direction)) < 1e-10);+ camera.orbit(.1, .1);+ assert(camera.view.elements.every(Number.isFinite));+ }+});+test("resolved occurrence materials retain shared geometry and camera metadata uses Telos authority", () => {const definition = {id: "shared",diff --git a/aetheris.client/src/App.css b/aetheris.client/src/App.cssindex 44ff73ad..8d48721a 100644--- a/aetheris.client/src/App.css+++ b/aetheris.client/src/App.css@@ -101,9 +101,13 @@overflow-wrap: anywhere;}-.import-status-box__details-list {+.diagnostic-summary {+ display: grid;+ gap: 8px;+}++.diagnostic-summary p {margin: 0;- padding-left: 16px;}.import-status-box--success {@@ -350,14 +354,6 @@gap: var(--layout-space-1);}-.boolean-grid {- grid-template-columns: 1fr;-}--.boolean-actions {- margin-bottom: var(--layout-space-1);-}-.tool-rail ul {margin: 0;padding-left: 16px;diff --git a/aetheris.client/src/App.tsx b/aetheris.client/src/App.tsxindex f12fa20b..6b8943f4 100644--- a/aetheris.client/src/App.tsx+++ b/aetheris.client/src/App.tsx@@ -14,9 +14,7 @@ import "./App.css";import {ApiError,claimStartupStep,- createBox,createDocument,- executeBoolean,exportDefinitionStep,getDocumentSummary,measureDocument,@@ -25,8 +23,6 @@ import {pickBody,prepareBodyDisplay,prepareAssemblyDisplay,- translateBody,- type BooleanOperation,type BodyOccurrenceSummaryDto,type DiagnosticDto,type PickHitDto,@@ -35,7 +31,10 @@ import {type PaperclipDemoResponseDto,} from "./api/aetherisApi";import { StepImportDropzone } from "./components/StepImportDropzone";+import { DiagnosticSummary } from "./components/DiagnosticSummary";import { ProductGallery } from "./components/ProductGallery";+import { ModelingDemo } from "./components/ModelingDemo";+import { stepExportFileName } from "./application/exportFileName";import { PropertyTable, type PropertyRecord } from "./components/PropertyTable";import { SemanticInspector } from "./components/SemanticInspector";import { Button } from "./components/ui/button";@@ -63,7 +62,6 @@ import {import { DEFAULT_PMI_VISIBILITY, type PmiCategory, type PmiVisibility } from "./viewer/pmiPresentation";type RequestStatus = "idle" | "loading" | "success" | "error";-type BooleanOperationUi = "Union" | "Subtract" | "Intersect";type TopLevelTab = "gallery" | "viewer" | "paperclips" | "modeling-demo";type ServerStatus = "connecting" | "connected" | "disconnected" | "error";type DocumentStatus = "creating" | "ready" | "error";@@ -119,12 +117,6 @@ interface RefreshDisplayResult {error: ApiError | null;}-const BOOLEAN_OP_TO_API: Record<BooleanOperationUi, BooleanOperation> = {- Union: "union",- Subtract: "subtract",- Intersect: "intersect",-};-function createDisplayStatusSummary(preparation: DisplayPreparationResponseDto | null,): DisplayStatusSummary | null {@@ -210,22 +202,14 @@ function App() {);const [pickDiagnostics, setPickDiagnostics] = useState<DiagnosticDto[]>([]);const [pickHits, setPickHits] = useState<PickHitDto[]>([]);- const [boxWidth, setBoxWidth] = useState("1.75");- const [boxHeight, setBoxHeight] = useState("1.25");- const [boxDepth, setBoxDepth] = useState("1.1");const [paperclipWireDiameter, setPaperclipWireDiameter] = useState("1");const [paperclipOuterLegLength, setPaperclipOuterLegLength] = useState("15");const [paperclipInnerLegLength, setPaperclipInnerLegLength] = useState("14");const [paperclipOuterBendRadius, setPaperclipOuterBendRadius] = useState("5");const [paperclipInnerBendRadius, setPaperclipInnerBendRadius] = useState("3");const [paperclipResult, setPaperclipResult] = useState<PaperclipDemoResponseDto | null>(null);- const [tx, setTx] = useState("0");- const [ty, setTy] = useState("0");- const [tz, setTz] = useState("0");- const [booleanTargetBodyId, setBooleanTargetBodyId] = useState<string>("");- const [booleanToolBodyId, setBooleanToolBodyId] = useState<string>("");- const [booleanOperation, setBooleanOperation] = useState<BooleanOperationUi>("Union");const [stepExportText, setStepExportText] = useState("");+ const [stepExportName, setStepExportName] = useState<string | null>(null);const [stepImportFile, setStepImportFile] = useState<File | null>(null);const [stepDropzoneResetToken, setStepDropzoneResetToken] = useState(0);const [stepCanonicalHash, setStepCanonicalHash] = useState<string | null>(null);@@ -260,10 +244,8 @@ function App() {setPickMessage("Click in the viewport to run nearest-hit pick.");setPickDiagnostics([]);setPickHits([]);- setBooleanTargetBodyId("");- setBooleanToolBodyId("");- setBooleanOperation("Union");setStepExportText("");+ setStepExportName(null);setStepImportFile(null);setStepDropzoneResetToken((value) => value + 1);setStepCanonicalHash(null);@@ -396,82 +378,6 @@ function App() {void handleCreateDocument();}, [handleCreateDocument]);- const handleCreateBox = useCallback(async () => {- if (!documentId) {- return;- }-- const width = Number(boxWidth);- const height = Number(boxHeight);- const depth = Number(boxDepth);-- if (- width <= 0 ||- height <= 0 ||- depth <= 0 ||- Number.isNaN(width) ||- Number.isNaN(height) ||- Number.isNaN(depth)- ) {- setStatus("error");- setStatusMessage("Box dimensions must be positive numbers.");- return;- }-- await runAction("Create box", async () => {- const created = await createBox(documentId, width, height, depth);- await refreshSummaryAndActiveTessellation(created.bodyId);- setPickStatus("idle");- setPickMessage("Click in the viewport to run nearest-hit pick.");- setPickDiagnostics([]);- setPickHits([]);- });- }, [boxDepth, boxHeight, boxWidth, documentId, refreshSummaryAndActiveTessellation, runAction]);-- const handleSelectBody = useCallback(- async (nextBodyId: string) => {- if (!documentId) {- return;- }-- await runAction("Select active body", async () => {- const preparedDisplay = await prepareBodyDisplay(documentId, nextBodyId);- setActiveBodyId(nextBodyId);- setDisplayPreparation(preparedDisplay);- setPickStatus("idle");- setPickMessage("Active body changed. Click in viewport to pick nearest hit.");- setPickDiagnostics([]);- setPickHits([]);- });- },- [documentId, runAction],- );-- const handleApplyTranslation = useCallback(async () => {- if (!documentId || !activeBodyId) {- return;- }-- const x = Number(tx);- const y = Number(ty);- const z = Number(tz);-- if ([x, y, z].some((value) => Number.isNaN(value))) {- setStatus("error");- setStatusMessage("Translation values must be valid numbers.");- return;- }-- await runAction("Apply translation", async () => {- await translateBody(documentId, activeBodyId, { x, y, z });- await refreshSummaryAndActiveTessellation(activeBodyId);- setPickStatus("idle");- setPickMessage("Occurrence translated. Click in viewport to refresh nearest hit.");- setPickDiagnostics([]);- setPickHits([]);- });- }, [activeBodyId, documentId, refreshSummaryAndActiveTessellation, runAction, tx, ty, tz]);-const handleRefreshDisplay = useCallback(async () => {if (!assemblySourcePath && (!documentId || !activeBodyId)) {return;@@ -530,7 +436,7 @@ function App() {try {const anchor = document.createElement("a");anchor.href = objectUrl;- anchor.download = `aetheris-${activeOccurrence.definitionId}.step`;+ anchor.download = stepExportName ?? stepExportFileName(activeOccurrence.name);document.body.appendChild(anchor);anchor.click();document.body.removeChild(anchor);@@ -538,7 +444,7 @@ function App() {URL.revokeObjectURL(objectUrl);}});- }, [activeOccurrence, documentId, runAction]);+ }, [activeOccurrence, documentId, runAction, stepExportName]);const handleCopyCanonicalHash = useCallback(async () => {if (!stepCanonicalHash) {@@ -559,7 +465,7 @@ function App() {fileName: string,sourceKind: "browser-file" | "startup-file" = "browser-file",) => {- if (!documentId || documentStatus !== "ready" || serverStatus !== "connected") return;+ if (!documentId || documentStatus !== "ready" || serverStatus !== "connected") return false;dispatchDocumentEvent({ type: "Open", source: { kind: sourceKind, fileName } });setImportStatus("importing");setImportStatusMessage(`Importing ${fileName}…`);@@ -575,6 +481,8 @@ function App() {}const imported = await importStep(documentId, stepText, fileName);+ setAssemblySourcePath(null);+ setStepExportName(stepExportFileName(fileName));const qualificationStatus = imported.importStatus ?? "Inspectable";setDiagnostics(imported.diagnostics);if (imported.assemblyPresentation) {@@ -592,7 +500,7 @@ function App() {setImportStatus("success");setImportStatusMessage(`${qualificationStatus}: ${imported.assemblyPresentation.occurrences.length - 1} occurrences, ${imported.assemblyPresentation.definitions.length} definitions. ${qualificationStatus === "Degraded" ? "Engineering checks are incomplete; see diagnostics." : qualificationStatus === "Inspectable" ? "Import qualification is incomplete." : ""}`);dispatchDocumentEvent({ type: "LoadSucceeded", documentId });- return;+ return true;}setAssemblyPacket(null);const semanticPresentation = imported.semanticPresentation@@ -635,6 +543,7 @@ function App() {);}dispatchDocumentEvent({ type: "LoadSucceeded", documentId });+ return !displayRefresh.error;} catch (error) {const apiError =error instanceof ApiError@@ -646,6 +555,7 @@ function App() {setImportStatus("error");setImportStatusMessage(`Import error: ${apiError.message}`);dispatchDocumentEvent({ type: "LoadFailed", error: apiError.message });+ return false;} finally {setIsImporting(false);}@@ -695,7 +605,7 @@ function App() {const generated = await maximizePaperclips({ wireDiameter, outerLegLength, innerLegLength, outerBendRadius, innerBendRadius,material: "Standard.Materials.StainlessSteel.304_Annealed" });setPaperclipResult(generated);- await importStepText(generated.stepText, "maximum-paperclip.step");+ if (!await importStepText(generated.stepText, "maximum-paperclip.step")) return;setStatus("success"); setStatusMessage("Optimization complete. 1 manufacturable paperclip generated. No planetary resources consumed.");} catch (error) {const apiError = error instanceof ApiError ? error : new ApiError((error as Error).message || "Paperclip generation failed.", []);@@ -767,65 +677,6 @@ function App() {setStepImportFile(null);}, []);- const handleUseActiveBodyAsTarget = useCallback(() => {- if (activeBodyId) {- setBooleanTargetBodyId(activeBodyId);- }- }, [activeBodyId]);-- const handleUseActiveBodyAsTool = useCallback(() => {- if (activeBodyId) {- setBooleanToolBodyId(activeBodyId);- }- }, [activeBodyId]);-- const handleExecuteBoolean = useCallback(async () => {- if (!documentId) {- return;- }-- if (!booleanTargetBodyId || !booleanToolBodyId) {- setStatus("error");- setStatusMessage("Boolean operation requires both target and tool occurrences.");- setDiagnostics([]);- return;- }-- if (booleanTargetBodyId === booleanToolBodyId) {- setStatus("error");- setStatusMessage("Boolean target and tool must be different occurrences.");- setDiagnostics([]);- return;- }-- await runAction(`Boolean ${booleanOperation}`, async () => {- const result = await executeBoolean(documentId, {- leftBodyId: booleanTargetBodyId,- rightBodyId: booleanToolBodyId,- operation: BOOLEAN_OP_TO_API[booleanOperation],- });-- await refreshSummaryAndActiveTessellation(result.bodyId);- setBooleanTargetBodyId(result.bodyId);- setPickStatus("idle");- setPickMessage(- `Boolean ${booleanOperation} succeeded. Result body ${result.bodyId} is now active.`,- );- setPickDiagnostics([]);- setPickHits([]);- setStatusMessage(- `Boolean ${booleanOperation} succeeded: target ${booleanTargetBodyId}, tool ${booleanToolBodyId}, result ${result.bodyId}.`,- );- });- }, [- booleanOperation,- booleanTargetBodyId,- booleanToolBodyId,- documentId,- refreshSummaryAndActiveTessellation,- runAction,- ]);-const handlePickRay = useCallback(async (origin: { x: number; y: number; z: number },@@ -910,14 +761,6 @@ function App() {!isImporting &&status !== "loading",);- const canExecuteBoolean = Boolean(- documentId &&- bodyIds.length >= 2 &&- booleanTargetBodyId &&- booleanToolBodyId &&- booleanTargetBodyId !== booleanToolBodyId &&- status !== "loading",- );const serverStatusLabel: Record<ServerStatus, string> = {connecting: "Server: Connecting",connected: "Server: Connected",@@ -1411,29 +1254,12 @@ function App() {<><p className="import-status-box__summary">Import failed</p><p className="import-status-box__detail">{statusMessage}</p>- {diagnostics.length === 0 ? null : (- <ul className="import-status-box__details-list">- {diagnostics.map((diagnostic, index) => (- <li key={`${diagnostic.code}-${index}`}>- [{diagnostic.severity}] {diagnostic.code}: {diagnostic.message}- </li>- ))}- </ul>- )}</>) : (<p>{importStatusMessage}</p>)}</div>- {importStatus === "error" || diagnostics.length === 0 ? null : (- <ul>- {diagnostics.map((diagnostic, index) => (- <li key={`${diagnostic.code}-${index}`}>- [{diagnostic.severity}] {diagnostic.code}: {diagnostic.message}- </li>- ))}- </ul>- )}+ <DiagnosticSummary diagnostics={diagnostics} /></section><section className="tool-section">@@ -1493,7 +1319,7 @@ function App() {</section></>) : activeTab === "gallery" ? (- <ProductGallery onPreview={async (step, name) => { await importStepText(step, name); }} />+ <ProductGallery onPreview={importStepText} />) : activeTab === "paperclips" ? (<section className="tool-section paperclip-forge"><p className="paperclip-forge__eyebrow">OBJECTIVE: MAKE PAPERCLIPS.</p>@@ -1533,195 +1359,9 @@ function App() {</section>) : (<>- <section className="tool-section">- <h2 className="section-title">Modeling Demo Notice</h2>- <p>Modeling Demo (Non-production)</p>- <p className="demo-notice">- This is a demo environment. Not part of Viewer v0 contract.- </p>- </section>-- <section className="tool-section">- <h2 className="section-title">Create Box</h2>- <div className="form-grid">- <label>- Width{" "}- <input- type="number"- value={boxWidth}- onChange={(event) => setBoxWidth(event.target.value)}- />- </label>- <label>- Height{" "}- <input- type="number"- value={boxHeight}- onChange={(event) => setBoxHeight(event.target.value)}- />- </label>- <label>- Depth{" "}- <input- type="number"- value={boxDepth}- onChange={(event) => setBoxDepth(event.target.value)}- />- </label>- </div>- <button- type="button"- onClick={() => void handleCreateBox()}- disabled={!documentId || status === "loading"}- >- Create Box- </button>- </section>-- <section className="tool-section">- <h2 className="section-title">Body List</h2>- {bodyIds.length === 0 ? (- <p>No occurrences in document.</p>- ) : (- <ul>- {bodyIds.map((bodyId) => {- const occurrence = occurrences.find((item) => item.occurrenceId === bodyId);- const label = occurrence- ? `${bodyId} (def ${occurrence.definitionId.slice(0, 8)}, t=[${occurrence.translation.x.toFixed(2)}, ${occurrence.translation.y.toFixed(2)}, ${occurrence.translation.z.toFixed(2)}])`- : bodyId;-- return (- <li key={bodyId}>- <button- type="button"- className={bodyId === activeBodyId ? "active-row" : ""}- onClick={() => void handleSelectBody(bodyId)}- disabled={status === "loading"}- >- {label}- </button>- </li>- );- })}- </ul>- )}- </section>-- <section className="tool-section">- <h2 className="section-title">Translate Active Body</h2>- <div className="form-grid">- <label>- X{" "}- <input- type="number"- value={tx}- onChange={(event) => setTx(event.target.value)}- />- </label>- <label>- Y{" "}- <input- type="number"- value={ty}- onChange={(event) => setTy(event.target.value)}- />- </label>- <label>- Z{" "}- <input- type="number"- value={tz}- onChange={(event) => setTz(event.target.value)}- />- </label>- </div>- <button- type="button"- onClick={() => void handleApplyTranslation()}- disabled={!activeBodyId || status === "loading"}- >- Apply Translation- </button>- </section>-- <section className="tool-section">- <h2 className="section-title">Boolean (Two-body)</h2>- <div className="form-grid boolean-grid">- <label>- Target Body- <select- value={booleanTargetBodyId}- onChange={(event) => setBooleanTargetBodyId(event.target.value)}- >- <option value="">Select target body</option>- {bodyIds.map((bodyId) => (- <option key={`target-${bodyId}`} value={bodyId}>- {bodyId}- </option>- ))}- </select>- </label>- <label>- Tool Body- <select- value={booleanToolBodyId}- onChange={(event) => setBooleanToolBodyId(event.target.value)}- >- <option value="">Select tool body</option>- {bodyIds.map((bodyId) => (- <option key={`tool-${bodyId}`} value={bodyId}>- {bodyId}- </option>- ))}- </select>- </label>- <label>- Operation- <select- value={booleanOperation}- onChange={(event) =>- setBooleanOperation(event.target.value as BooleanOperationUi)- }- >- <option value="Union">Union</option>- <option value="Subtract">Subtract</option>- <option value="Intersect">Intersect</option>- </select>- </label>- </div>- <div className="stack-row boolean-actions">- <button- type="button"- onClick={handleUseActiveBodyAsTarget}- disabled={!activeBodyId || status === "loading"}- >- Use Active as Target- </button>- <button- type="button"- onClick={handleUseActiveBodyAsTool}- disabled={!activeBodyId || status === "loading"}- >- Use Active as Tool- </button>- </div>- <button- type="button"- onClick={() => void handleExecuteBoolean()}- disabled={!canExecuteBoolean}- >- Execute Boolean- </button>- {bodyIds.length < 2 ? <p>Need at least 2 bodies to run a boolean.</p> : null}- {booleanTargetBodyId &&- booleanToolBodyId &&- booleanTargetBodyId === booleanToolBodyId ? (- <p>Target and tool must be different body IDs.</p>- ) : null}- </section>-- <section className="tool-section">- <h2 className="section-title">Debug/Status</h2>+ <ModelingDemo onPreview={importStepText} />+ <details className="tool-section">+ <summary className="section-title">Developer diagnostics</summary><p><strong>Request status:</strong> {status}</p>@@ -1820,15 +1460,9 @@ function App() {{diagnostics.length === 0 ? (<p>None</p>) : (- <ul>- {diagnostics.map((diagnostic, index) => (- <li key={`${diagnostic.code}-${index}`}>- [{diagnostic.severity}] {diagnostic.code}: {diagnostic.message}- </li>- ))}- </ul>+ <DiagnosticSummary diagnostics={diagnostics} />)}- </section>+ </details></>)}</aside>diff --git a/aetheris.client/src/__tests__/App.test.tsx b/aetheris.client/src/__tests__/App.test.tsxindex 19830025..e03c07c3 100644--- a/aetheris.client/src/__tests__/App.test.tsx+++ b/aetheris.client/src/__tests__/App.test.tsx@@ -7,7 +7,9 @@ import { STEP_UPLOAD_LIMIT_BYTES } from "../config/stepUpload";const apiMocks = vi.hoisted(() => ({createDocument: vi.fn(),claimStartupStep: vi.fn(),- createBox: vi.fn(),+ composeBlock: vi.fn(),+ listGalleryTemplates: vi.fn(),+ invokeGalleryTemplate: vi.fn(),executeBoolean: vi.fn(),exportDefinitionStep: vi.fn(),getDocumentSummary: vi.fn(),@@ -26,7 +28,9 @@ vi.mock("../api/aetherisApi", async () => {...actual,createDocument: apiMocks.createDocument,claimStartupStep: apiMocks.claimStartupStep,- createBox: apiMocks.createBox,+ composeBlock: apiMocks.composeBlock,+ listGalleryTemplates: apiMocks.listGalleryTemplates,+ invokeGalleryTemplate: apiMocks.invokeGalleryTemplate,executeBoolean: apiMocks.executeBoolean,exportDefinitionStep: apiMocks.exportDefinitionStep,getDocumentSummary: apiMocks.getDocumentSummary,@@ -48,14 +52,8 @@ vi.mock("../viewer/AetherisViewport", () => ({function setupDocumentApiMocks(): void {apiMocks.createDocument.mockResolvedValue({ documentId: "doc-1", name: "Test", volatile: true });apiMocks.claimStartupStep.mockResolvedValue(null);- apiMocks.createBox.mockResolvedValue({- documentId: "doc-1",- bodyId: "occ-2",- definitionId: "def-2",- faceCount: 6,- edgeCount: 12,- vertexCount: 8,- });+ apiMocks.importStep.mockResolvedValue({ documentId: 'doc-1', definitionId: 'def-2', occurrenceId: 'occ-2', name: 'Imported', diagnostics: [] });+ apiMocks.composeBlock.mockResolvedValue({ stepText: 'STEP', exportPath: 'composed-block.step', source: 'Model ComposedBlock {}', materializationRoute: 'PrismaticSectionStack/Add' });apiMocks.getDocumentSummary.mockResolvedValue({documentId: "doc-1",name: "Test",@@ -112,8 +110,8 @@ describe("App STEP file upload flow", () => {fireEvent.click(screen.getByRole("tab", { name: /Modeling Demo/i }));- expect(screen.getByText("Modeling Demo (Non-production)")).toBeTruthy();- expect(screen.getByRole("button", { name: "Create Box" })).toBeTruthy();+ expect(screen.getByText("Compose blocks")).toBeTruthy();+ expect(screen.getByRole("button", { name: "Build composed part" })).toBeTruthy();});it("auto-creates a workspace and shows connected/ready status on startup", async () => {@@ -122,6 +120,34 @@ describe("App STEP file upload flow", () => {await screen.findByText("Server: Connected");await screen.findByText("Document: Ready");expect(apiMocks.createDocument).toHaveBeenCalledTimes(1);+ expect(apiMocks.importStep).not.toHaveBeenCalled();+ expect(apiMocks.composeBlock).not.toHaveBeenCalled();+ expect((screen.getByRole("button", { name: "Refresh Display Data" }) as HTMLButtonElement).disabled).toBe(true);+ });++ it("previews the gallery artifact with its authored export path", async () => {+ apiMocks.listGalleryTemplates.mockResolvedValue([{ id: "Standard.Products.Mechanical.MountingPlate", displayName: "Mounting Plate", parameters: [], artifacts: ["StepAp242"] }]);+ apiMocks.invokeGalleryTemplate.mockResolvedValue({ artifacts: [{ kind: "StepAp242", name: "part.step", exportPath: "products/mounting-plate.step", content: "GENERATED STEP", sha256: "abcdef" }], executionMilliseconds: 10 });+ render(<App />);+ await screen.findByText("Document: Ready");+ fireEvent.click(screen.getByRole("tab", { name: /Product Gallery/i }));+ await screen.findByRole("button", { name: "Generate / Update Part" });+ fireEvent.click(screen.getByRole("button", { name: "Generate / Update Part" }));+ await screen.findByText(/Generated in/);+ expect(apiMocks.importStep).toHaveBeenCalledWith("doc-1", "GENERATED STEP", "products/mounting-plate.step");+ expect(apiMocks.prepareBodyDisplay).toHaveBeenCalledWith("doc-1", "occ-2");+ });++ it("builds the composed part instead of invoking the retired Boolean controls", async () => {+ render(<App />);+ await screen.findByText("Document: Ready");+ fireEvent.click(screen.getByRole("tab", { name: /Modeling Demo/i }));+ expect(screen.queryByRole("button", { name: "Execute Boolean" })).toBeNull();+ fireEvent.click(screen.getByRole("button", { name: "Build composed part" }));+ await screen.findByText(/Composed block built/);+ expect(apiMocks.composeBlock).toHaveBeenCalledWith({ width: 80, depth: 50, height: 8, padWidth: 30, padDepth: 20, padHeight: 12 });+ expect(apiMocks.importStep).toHaveBeenCalledWith("doc-1", "STEP", "composed-block.step");+ expect(apiMocks.executeBoolean).not.toHaveBeenCalled();});it("switches the complete viewport theme without changing shell geography", () => {@@ -212,6 +238,13 @@ describe("App STEP file upload flow", () => {screen.getByText("No semantic Mates were inferred from occurrence transforms."),).toBeTruthy();expect(apiMocks.importStep).not.toHaveBeenCalled();+ fireEvent.change(screen.getByTestId("step-import-file-input"), { target: { files: [new File(["STEP"], "replacement.step")] } });+ await screen.findByText("replacement.step");+ fireEvent.click(screen.getByRole("button", { name: "Import STEP 242" }));+ await screen.findByText(/^Inspectable: Import complete/);+ fireEvent.click(screen.getByRole("button", { name: "Refresh Display Data" }));+ await waitFor(() => expect(apiMocks.prepareBodyDisplay).toHaveBeenCalledTimes(2));+ expect(apiMocks.prepareAssemblyDisplay).toHaveBeenCalledTimes(1);});it("shows a readable startup STEP load failure", async () => {@@ -465,6 +498,23 @@ describe("App STEP file upload flow", () => {await screen.findByText("hash-123");});+ it("preserves degraded import status without flooding the viewer with nonfatal diagnostics", async () => {+ apiMocks.importStep.mockResolvedValue({+ importStatus: "Degraded", documentId: "doc-1", definitionId: "def-2", occurrenceId: "occ-2", name: "Screw",+ diagnostics: Array.from({ length: 35 }, (_, i) => ({ code: "Unknown", severity: "Info", source: "Importer.Surface", message: `Spline #${i} reduced within budget; lengthy candidate details.` })),+ });+ render(<App />);+ await screen.findByText("Document: Ready");+ fireEvent.change(screen.getByTestId("step-import-file-input"), { target: { files: [new File(["STEP"], "screw.step")] } });+ await screen.findByText("screw.step");+ fireEvent.click(screen.getByRole("button", { name: "Import STEP 242" }));+ await screen.findByText(/^Degraded: Import complete\./);+ expect(screen.getByText(/35 informational messages/)).toBeTruthy();+ expect(screen.queryByText(/lengthy candidate details/)).toBeNull();+ expect(screen.getByRole("button", { name: "Download diagnostic log" })).toBeTruthy();+ expect(apiMocks.exportDefinitionStep).not.toHaveBeenCalled();+ });+it("App_DisplayStatus_ShowsMixedFallbackAsDisplayStatus", async () => {apiMocks.importStep.mockResolvedValue({documentId: "doc-1",@@ -779,9 +829,10 @@ describe("App STEP file upload flow", () => {render(<App />);await screen.findByText("Document: Ready");- fireEvent.click(screen.getByRole("tab", { name: /Modeling Demo/i }));- fireEvent.click(screen.getByRole("button", { name: "Create Box" }));- await screen.findByText(/Create box complete/i);+ fireEvent.change(screen.getByTestId("step-import-file-input"), { target: { files: [new File(["STEP"], "bracket.step")] } });+ await screen.findByText("bracket.step");+ fireEvent.click(screen.getByRole("button", { name: "Import STEP 242" }));+ await screen.findByText(/^Inspectable: Import complete/);fireEvent.click(screen.getByRole("tab", { name: /STEP 242 Viewer/i }));fireEvent.click(screen.getByRole("button", { name: "Export Active (STEP)" }));@@ -797,7 +848,7 @@ describe("App STEP file upload flow", () => {expect(await blob.text()).toBe("ISO-10303-21;DATA;ENDSEC;");const downloadAnchor = appendSpy.mock.calls.at(-1)?.[0] as HTMLAnchorElement;- expect(downloadAnchor.download).toBe("aetheris-def-2.step");+ expect(downloadAnchor.download).toBe("bracket.step");expect(anchorClickSpy).toHaveBeenCalledTimes(1);expect(revokeObjectUrlSpy).toHaveBeenCalledWith("blob:download");@@ -891,9 +942,10 @@ describe("App STEP file upload flow", () => {render(<App />);await screen.findByText("Document: Ready");- fireEvent.click(screen.getByRole("tab", { name: /Modeling Demo/i }));- fireEvent.click(screen.getByRole("button", { name: "Create Box" }));- await screen.findByText(/Create box complete/i);+ fireEvent.change(screen.getByTestId("step-import-file-input"), { target: { files: [new File(["STEP"], "bracket.step")] } });+ await screen.findByText("bracket.step");+ fireEvent.click(screen.getByRole("button", { name: "Import STEP 242" }));+ await screen.findByText(/^Inspectable: Import complete/);fireEvent.click(screen.getByRole("tab", { name: /STEP 242 Viewer/i }));fireEvent.click(screen.getByRole("button", { name: "Download Canonical 242" }));diff --git a/aetheris.client/src/__tests__/DiagnosticSummary.test.tsx b/aetheris.client/src/__tests__/DiagnosticSummary.test.tsxnew file mode 100644index 00000000..f1561312--- /dev/null+++ b/aetheris.client/src/__tests__/DiagnosticSummary.test.tsx@@ -0,0 +1,38 @@+import { cleanup, fireEvent, render, screen } from "@testing-library/react";+import { afterEach, expect, it, vi } from "vitest";+import { DiagnosticSummary } from "../components/DiagnosticSummary";++afterEach(() => { cleanup(); vi.restoreAllMocks(); vi.unstubAllGlobals(); });++it("summarizes nonfatal details and downloads every original diagnostic", async () => {+ const diagnostics = [+ { code: "Unknown", severity: "Info", source: "Importer.Surface", message: "Spline #4617 reduced within the 0.1 mm budget; analytic candidates rejected." },+ { code: "IncompleteCheck", severity: "Warning", source: "Importer.Qualification", message: "Engineering checks incomplete." },+ { code: "ValidationFailed", severity: "Error", source: "Viewer.Timeout", message: "View materialization failed." },+ ];+ const createObjectURL = vi.fn<(blob: Blob) => string>(() => "blob:diagnostics");+ vi.stubGlobal("URL", { createObjectURL, revokeObjectURL: vi.fn() });+ const click = vi.spyOn(HTMLAnchorElement.prototype, "click").mockImplementation(() => {});+ render(<DiagnosticSummary diagnostics={diagnostics} />);+ expect(screen.getByText(/1 error, 1 warning, 1 informational message/)).toBeTruthy();+ expect(screen.queryByText(/Spline #4617/)).toBeNull();+ expect(screen.queryByText("Engineering checks incomplete.")).toBeNull();+ expect(screen.getByText("[Error] ValidationFailed: View materialization failed.")).toBeTruthy();+ fireEvent.click(screen.getByRole("button", { name: "Download diagnostic log" }));+ expect((click.mock.instances[0] as HTMLAnchorElement).download).toBe("cadmata-diagnostics.log");+ const blob = createObjectURL.mock.calls[0][0] as Blob;+ const text = await new Promise<string>((resolve, reject) => {+ const reader = new FileReader();+ reader.onload = () => resolve(String(reader.result));+ reader.onerror = reject;+ reader.readAsText(blob);+ });+ for (const d of diagnostics) expect(text).toContain(`[${d.severity}] ${d.code} (${d.source}): ${d.message}`);+});++it("leaves an unfamiliar severity visible and keeps a quiet import quiet", () => {+ const { rerender } = render(<DiagnosticSummary diagnostics={[]} />);+ expect(screen.queryByRole("button")).toBeNull();+ rerender(<DiagnosticSummary diagnostics={[{ code: "FatalImport", severity: "Fatal", source: null, message: "Cannot import body." }]} />);+ expect(screen.getByText("[Fatal] FatalImport: Cannot import body.")).toBeTruthy();+});diff --git a/aetheris.client/src/__tests__/aetherisApi.test.ts b/aetheris.client/src/__tests__/aetherisApi.test.tsindex c5df8c4c..2cee57b9 100644--- a/aetheris.client/src/__tests__/aetherisApi.test.ts+++ b/aetheris.client/src/__tests__/aetherisApi.test.ts@@ -1,4 +1,5 @@import { afterEach, describe, expect, it, vi } from "vitest";+import * as desktopDiagnostics from "../desktopDiagnostics";import {ApiError,executeBoolean,@@ -309,6 +310,21 @@ describe("STEP API", () => {);});+ it.each([true, false])("copies complete import diagnostics to the native log (success=%s)", async success => {+ const diagnostics = [{ code: "Unknown", severity: success ? "Info" : "Error", message: "Spline source #4617: full diagnostic evidence.", source: "Importer.Surface" }];+ const report = vi.spyOn(desktopDiagnostics, "reportDesktopDiagnostic").mockImplementation(() => {});+ vi.stubGlobal("fetch", vi.fn().mockResolvedValue(new Response(JSON.stringify({+ success, data: success ? { documentId: "doc-1", diagnostics } : null, diagnostics: success ? [] : diagnostics,+ }), { status: success ? 200 : 422 })));+ try {+ if (success) expect((await importStep("doc-1", "STEP")).diagnostics).toEqual(diagnostics);+ else await expect(importStep("doc-1", "BAD")).rejects.toBeInstanceOf(ApiError);+ expect(report).toHaveBeenCalledWith(success ? "CAD diagnostics" : "CAD request failed", expect.objectContaining({+ path: "/api/v1/documents/doc-1/import/step", diagnostics,+ }));+ } finally { report.mockRestore(); }+ });+it("parses importStep success envelope", async () => {const fetchMock = vi.fn().mockResolvedValue(new Response(diff --git a/aetheris.client/src/__tests__/exportFileName.test.ts b/aetheris.client/src/__tests__/exportFileName.test.tsnew file mode 100644index 00000000..459e123f--- /dev/null+++ b/aetheris.client/src/__tests__/exportFileName.test.ts@@ -0,0 +1,8 @@+import { expect, it } from "vitest";+import { stepExportFileName } from "../application/exportFileName";++it("preserves a product leaf name across Windows/browser paths without runtime identities", () => {+ expect(stepExportFileName("exports/products/mounting-plate.step")).toBe("mounting-plate.step");+ expect(stepExportFileName("C:\\parts\\M6 screw.STP")).toBe("M6 screw.step");+ expect(stepExportFileName(null)).toBe("part.step");+});diff --git a/aetheris.client/src/api/aetherisApi.ts b/aetheris.client/src/api/aetherisApi.tsindex f2d4bc67..24c8f989 100644--- a/aetheris.client/src/api/aetherisApi.ts+++ b/aetheris.client/src/api/aetherisApi.ts@@ -96,10 +96,10 @@ export interface PaperclipDemoResponseDto {deterministic: boolean;}-export type ForgeArtifactKindDto = "StepAp242" | "FlatStep" | "Svg";+export type ForgeArtifactKindDto = "StepAp242" | "FlatStep" | "Svg" | "CutListJson";export interface ForgeTemplateParameterDto { name: string; type: string; required: boolean; default?: string | null; dimension?: string | null; unit?: string | null; allowedValues?: string[] | null; fields?: ForgeTemplateParameterDto[] | null; category: string; constraint?: string | null; }export interface ForgeTemplateDescriptionDto { id: string; displayName: string; version: string; documentation: string; parameters: ForgeTemplateParameterDto[]; artifacts: ForgeArtifactKindDto[]; signature: string; outputKind: string; constraints: { name: string; expression: string }[]; }-export interface GalleryArtifactDto { kind: ForgeArtifactKindDto; name: string; contentType: string; size: number; sha256: string; content: string; }+export interface GalleryArtifactDto { kind: ForgeArtifactKindDto; name: string; exportPath?: string | null; contentType: string; size: number; sha256: string; content: string; }export interface GalleryInvocationResponseDto { success: boolean; identity: { template: string; templateVersion: string; specialization?: string | null }; diagnostics: { code: string; severity: string; message: string; target?: string | null }[]; artifacts: GalleryArtifactDto[]; executionMilliseconds: number; }export type BooleanOperation = "union" | "subtract" | "intersect";@@ -481,11 +481,15 @@ async function request<T>(path: string, init: RequestInit): Promise<T> {try {const result = await parseEnvelope<T>(response);+ if (result && typeof result === "object" && "diagnostics" in result+ && Array.isArray(result.diagnostics) && result.diagnostics.length > 0)+ reportDesktopDiagnostic("CAD diagnostics", { path, status: response.status, diagnostics: result.diagnostics });if (/import\/step|export\/step|assembly/.test(path))reportDesktopDiagnostic("CAD request", { path, status: response.status });return result;} catch (error) {- reportDesktopDiagnostic("CAD request failed", { path, status: response.status, message: String(error) });+ reportDesktopDiagnostic("CAD request failed", { path, status: response.status, message: String(error),+ diagnostics: error instanceof ApiError ? error.diagnostics : [] });throw error;}}@@ -609,6 +613,12 @@ export async function importStep(});}+export function composeBlock(dimensions: { width: number; depth: number; height: number; padWidth: number; padDepth: number; padHeight: number }) {+ return request<{ stepText: string; exportPath: string; source: string; materializationRoute: string }>("/api/v1/demos/composed-block", {+ method: "POST", body: JSON.stringify(dimensions),+ });+}+export async function claimStartupStep(): Promise<StartupStepDto | null> {const response = await fetch("/api/v1/startup/step", { method: "POST" });if (response.status === 204) {@@ -631,9 +641,9 @@ export async function listGalleryTemplates(): Promise<ForgeTemplateDescriptionDtreturn request<ForgeTemplateDescriptionDto[]>("/api/v1/gallery/templates", {});}-export async function invokeGalleryTemplate(templateId: string, parameters: Record<string, unknown>, artifacts: ForgeArtifactKindDto[]): Promise<GalleryInvocationResponseDto> {+export async function invokeGalleryTemplate(templateId: string, parameters: Record<string, unknown>, artifacts: ForgeArtifactKindDto[], exportPath?: string): Promise<GalleryInvocationResponseDto> {return request<GalleryInvocationResponseDto>(`/api/v1/gallery/templates/${encodeURIComponent(templateId)}`, {- method: "POST", body: JSON.stringify({ arguments: parameters, artifacts }),+ method: "POST", body: JSON.stringify({ arguments: parameters, artifacts, exportPath }),});}diff --git a/aetheris.client/src/application/exportFileName.ts b/aetheris.client/src/application/exportFileName.tsnew file mode 100644index 00000000..ef6bd440--- /dev/null+++ b/aetheris.client/src/application/exportFileName.ts@@ -0,0 +1,6 @@+/** Browser downloads use the product's leaf name, never host paths or runtime IDs. */+export function stepExportFileName(path: string | null | undefined): string {+ const name = (path ?? "").split(/[\\/]/).pop() ?? "";+ const leaf = [...name].map(char => char.charCodeAt(0) < 32 || '<>:"|?*'.includes(char) ? "_" : char).join("").trim();+ return leaf ? leaf.replace(/\.(?:step|stp)$/i, "") + ".step" : "part.step";+}diff --git a/aetheris.client/src/components/DiagnosticSummary.tsx b/aetheris.client/src/components/DiagnosticSummary.tsxnew file mode 100644index 00000000..363fb5bf--- /dev/null+++ b/aetheris.client/src/components/DiagnosticSummary.tsx@@ -0,0 +1,36 @@+import type { DiagnosticDto } from "../api/aetherisApi";+import { Button } from "./ui/button";++/** Keep engineering status separate from verbose importer/debug evidence. */+export function DiagnosticSummary({ diagnostics }: { diagnostics: DiagnosticDto[] }) {+ if (diagnostics.length === 0) return null;+ const warnings = diagnostics.filter(d => d.severity.toLowerCase() === "warning").length;+ const infos = diagnostics.filter(d => ["info", "information"].includes(d.severity.toLowerCase())).length;+ // Unknown severities stay visible rather than being silently hidden.+ const errors = diagnostics.filter(d => !["warning", "info", "information"].includes(d.severity.toLowerCase()));+ const count = (n: number, label: string) => n ? `${n} ${label}${n === 1 ? "" : "s"}` : "";+ const counts = [count(errors.length, "error"), count(warnings, "warning"), count(infos, "informational message")].filter(Boolean).join(", ");+ const download = () => {+ const content = `Cadmata diagnostics\nCaptured: ${new Date().toISOString()}\n${counts}\n\n`+ + diagnostics.map(d => `[${d.severity}] ${d.code}${d.source ? ` (${d.source})` : ""}: ${d.message}`).join("\n\n");+ const url = URL.createObjectURL(new Blob([content], { type: "text/plain;charset=utf-8" }));+ const link = document.createElement("a");+ link.href = url;+ link.download = "cadmata-diagnostics.log";+ link.click();+ setTimeout(() => URL.revokeObjectURL(url), 1000);+ };+ return (+ <div className="diagnostic-summary">+ <p>{counts}. Full details are available in the diagnostic log.</p>+ {errors.length > 0 && (+ <ul>+ {errors.map((d, i) => (+ <li key={`${d.code}-${i}`}>[{d.severity}] {d.code}: {d.message}</li>+ ))}+ </ul>+ )}+ <Button type="button" variant="outline" onClick={download}>Download diagnostic log</Button>+ </div>+ );+}diff --git a/aetheris.client/src/components/ModelingDemo.tsx b/aetheris.client/src/components/ModelingDemo.tsxnew file mode 100644index 00000000..c5205ad3--- /dev/null+++ b/aetheris.client/src/components/ModelingDemo.tsx@@ -0,0 +1,34 @@+import { useState } from "react";+import { composeBlock } from "../api/aetherisApi";+import { Button } from "./ui/button";++export function ModelingDemo({ onPreview }: { onPreview(step: string, name: string): Promise<boolean> }) {+ const [values, setValues] = useState({ width: 80, depth: 50, height: 8, padWidth: 30, padDepth: 20, padHeight: 12 });+ const [busy, setBusy] = useState(false);+ const [message, setMessage] = useState("Build a base with a centered raised block. All dimensions are in mm.");+ const [source, setSource] = useState("");+ const generate = async () => {+ if (busy) return;+ setBusy(true);+ try {+ const built = await composeBlock(values);+ setSource(built.source);+ if (!await onPreview(built.stepText, built.exportPath)) throw new Error("Build succeeded, but display failed. See import diagnostics.");+ setMessage("Composed block built. Edit dimensions and build again to update it.");+ } catch (error) { setMessage(error instanceof Error ? error.message : "Build failed."); }+ finally { setBusy(false); }+ };+ return <section className="tool-section">+ <h2 className="section-title">Compose blocks</h2>+ <p>Construct one part from a base and a raised block using Firmament Compose.</p>+ <div className="form-grid">+ {(Object.keys(values) as (keyof typeof values)[]).map(key => <label key={key}>+ {({ width: "Base width", depth: "Base depth", height: "Base height", padWidth: "Raised width", padDepth: "Raised depth", padHeight: "Raised height" })[key]} (mm)+ <input type="number" min="0.1" step="0.1" value={values[key]} onChange={event => setValues(current => ({ ...current, [key]: Number(event.target.value) }))} />+ </label>)}+ </div>+ <Button type="button" disabled={busy} onClick={() => void generate()}>{busy ? "Building…" : "Build composed part"}</Button>+ <p role="status">{message}</p>+ {source && <details><summary>Firmament source</summary><pre style={{ whiteSpace: "pre-wrap" }}>{source}</pre></details>}+ </section>;+}diff --git a/aetheris.client/src/components/ProductGallery.tsx b/aetheris.client/src/components/ProductGallery.tsxindex 2c23bb1f..75623423 100644--- a/aetheris.client/src/components/ProductGallery.tsx+++ b/aetheris.client/src/components/ProductGallery.tsx@@ -1,6 +1,7 @@import { useEffect, useMemo, useState } from "react";import { ApiError, invokeGalleryTemplate, listGalleryTemplates, type ForgeTemplateDescriptionDto, type GalleryArtifactDto } from "../api/aetherisApi";import { Button } from "./ui/button";+import { stepExportFileName } from "../application/exportFileName";const DEFAULT_SELECTED = "Standard.Products.Mechanical.MountingPlate";@@ -14,34 +15,38 @@ function schemaDefaults(template: ForgeTemplateDescriptionDto | undefined): Recofunction download(artifact: GalleryArtifactDto) {const url = URL.createObjectURL(new Blob([artifact.content], { type: artifact.contentType }));- const anchor = document.createElement("a"); anchor.href = url; anchor.download = artifact.name; anchor.click(); URL.revokeObjectURL(url);+ const anchor = document.createElement("a"); anchor.href = url; anchor.download = artifact.kind === "StepAp242" ? stepExportFileName(artifact.exportPath ?? artifact.name) : artifact.name; anchor.click(); URL.revokeObjectURL(url);}-export function ProductGallery({ onPreview }: { onPreview: (step: string, name: string) => Promise<void> }) {+export function ProductGallery({ onPreview }: { onPreview: (step: string, name: string) => Promise<boolean> }) {const [templates, setTemplates] = useState<ForgeTemplateDescriptionDto[]>([]);const [selectedId, setSelectedId] = useState(DEFAULT_SELECTED);+ const [exportPath, setExportPath] = useState("MountingPlate.step");const [values, setValues] = useState<Record<string, string | number>>({});const [artifacts, setArtifacts] = useState<GalleryArtifactDto[]>([]);const [status, setStatus] = useState("Loading Standard Library…");+ const [generating, setGenerating] = useState(false);const selected = useMemo(() => templates.find((item) => item.id === selectedId), [templates, selectedId]);const fields = selected?.parameters.flatMap((parameter) => parameter.fields ?? [parameter]) ?? [];useEffect(() => { void listGalleryTemplates().then((items) => { setTemplates(items); setValues(schemaDefaults(items.find((item) => item.id === DEFAULT_SELECTED))); setStatus(`${items.length} product families available.`); }).catch((error: Error) => setStatus(error.message)); }, []);- const choose = (id: string) => { setSelectedId(id); setValues(schemaDefaults(templates.find((item) => item.id === id))); setArtifacts([]); setStatus("Ready to generate."); };+ const choose = (id: string) => { setSelectedId(id); setExportPath(`${id.split(".").pop()}.step`); setValues(schemaDefaults(templates.find((item) => item.id === id))); setArtifacts([]); setStatus("Ready to generate."); };const generate = async () => {- if (!selected) return; setStatus("Generating through Forge.Host…");+ if (!selected || generating) return; setGenerating(true); setStatus("Generating through Forge.Host…");try {- const result = await invokeGalleryTemplate(selected.id, values, selected.artifacts); setArtifacts(result.artifacts);- const step = result.artifacts.find((artifact) => artifact.kind === "StepAp242"); if (step) await onPreview(step.content, `${selected.displayName}.step`);+ const result = await invokeGalleryTemplate(selected.id, values, selected.artifacts, exportPath); setArtifacts(result.artifacts);+ const step = result.artifacts.find((artifact) => artifact.kind === "StepAp242");+ if (!step) throw new Error("Generation returned no STEP artifact to display.");+ if (!await onPreview(step.content, step.exportPath ?? step.name)) throw new Error("Part generated, but preview failed. See import diagnostics.");setStatus(`Generated in ${result.executionMilliseconds.toFixed(1)} ms · SHA256 ${step?.sha256.slice(0, 12) ?? "n/a"}.`);} catch (error) {const failure = error instanceof ApiError ? error : new ApiError((error as Error).message, []); setStatus(failure.diagnostics.map((item) => item.message).join(" · ") || failure.message);- }+ } finally { setGenerating(false); }};return <section className="tool-section product-gallery"><p className="product-gallery__eyebrow">AETHERIS STANDARD LIBRARY</p><h2>Engineering Product Gallery</h2>- <div className="product-gallery__cards">{templates.map((template) => <button type="button" key={template.id} className={template.id === selectedId ? "product-card active-row" : "product-card"} onClick={() => choose(template.id)}><strong>{template.displayName}</strong><span>{template.outputKind === "SheetMetal" ? "formed + flat" : "STEP AP242"}</span></button>)}</div>+ <div className="product-gallery__cards">{templates.map((template) => <button type="button" key={template.id} disabled={generating} className={template.id === selectedId ? "product-card active-row" : "product-card"} onClick={() => choose(template.id)}><strong>{template.displayName}</strong><span>{template.outputKind === "SheetMetal" ? "formed + flat" : "STEP AP242"}</span></button>)}</div>{selected ? <><h3>{selected.displayName}</h3><p>{selected.documentation}</p><div className="form-grid product-gallery__form">{fields.map((field) => <label key={field.name}>{field.name}{field.unit ? ` (${field.unit})` : ""}{field.allowedValues ? <select value={String(values[field.name] ?? "")} onChange={(event) => setValues((current) => ({ ...current, [field.name]: event.target.value }))}>{field.allowedValues.map((value) => <option key={value}>{value}</option>)}</select> : <input type="text" value={String(values[field.name] ?? "")} onChange={(event) => setValues((current) => ({ ...current, [field.name]: field.type === "number" ? Number(event.target.value) : event.target.value }))} />}</label>)}- </div><div className="stack-row"><Button type="button" onClick={() => void generate()}>Generate / Update Part</Button>{artifacts.map((artifact) => <Button key={artifact.kind} type="button" variant="secondary" onClick={() => download(artifact)}>Download {artifact.kind}</Button>)}</div><p role="status" className="demo-notice">{status}</p></> : <p>{status}</p>}+ </div><label>Export filename<input type="text" value={exportPath} disabled={generating} onChange={event => setExportPath(event.target.value)} /></label><div className="stack-row"><Button type="button" disabled={generating} onClick={() => void generate()}>Generate / Update Part</Button>{artifacts.map((artifact) => <Button key={artifact.kind} type="button" variant="secondary" onClick={() => download(artifact)}>Download {artifact.kind}</Button>)}</div><p role="status" className="demo-notice">{status}</p></> : <p>{status}</p>}</section>;}diff --git a/aetheris.client/src/viewer/AetherisViewport.tsx b/aetheris.client/src/viewer/AetherisViewport.tsxindex fa3ddad3..8629b0aa 100644--- a/aetheris.client/src/viewer/AetherisViewport.tsx+++ b/aetheris.client/src/viewer/AetherisViewport.tsx@@ -211,6 +211,7 @@ function TelosViewport(props: AetherisViewportProps & { onRetry(): void }) {setLabelHost(current);current.camera.mode = "orthographic";current.camera.up.set(0, 0, 1);+ current.camera.position.set(1, -1, .8);current.gridPlane = "xy";current.attach(container.current!);apply();@@ -249,6 +250,19 @@ function TelosViewport(props: AetherisViewportProps & { onRetry(): void }) {aria-label="Engineering WebGPU viewport"style={{ display: "block", width: "100%", height: "100%" }}/>+ <select aria-label="Standard view" defaultValue="" style={{ position: "absolute", left: 12, top: 54, zIndex: 3, width: 150 }}+ onChange={event => {+ const views: Record<string, [number[], number[]]> = {+ iso: [[1, -1, .8], [0, 0, 1]], top: [[0, 0, 1], [0, 1, 0]], bottom: [[0, 0, -1], [0, -1, 0]],+ front: [[0, -1, 0], [0, 0, 1]], back: [[0, 1, 0], [0, 0, 1]], left: [[-1, 0, 0], [0, 0, 1]], right: [[1, 0, 0], [0, 0, 1]],+ };+ const view = views[event.target.value];+ if (view && host.current) { host.current.camera.orient(...view); host.current.invalidate(); }+ event.target.value = "";+ }}>+ <option value="" disabled>Standard view</option><option value="iso">Isometric</option><option value="top">Top</option><option value="bottom">Bottom</option>+ <option value="front">Front</option><option value="back">Back</option><option value="left">Left</option><option value="right">Right</option>+ </select>{inspectionFaces.length > 0 && (<details style={{ position: "absolute", left: 12, bottom: 12, zIndex: 3,background: (props.theme ?? ATELIER_VIEWPORT_THEME).annotation.background,diff --git a/docs/development/reports/2026-10/CADMATA-BROWSER-FIRST.md b/docs/development/reports/2026-10/CADMATA-BROWSER-FIRST.mdnew file mode 100644index 00000000..5f93d295--- /dev/null+++ b/docs/development/reports/2026-10/CADMATA-BROWSER-FIRST.md@@ -0,0 +1,43 @@+# Cadmata browser-first packaging++Cadmata now opens the user's existing browser by default. The Windows convenience window reuses shared Evergreen WebView2; normal publication does not download or package a browser engine. Geometry code and modeling tolerances are unchanged by this pass.++## Changes and ownership++- `Cadmata.exe` is the console server/launcher; blank startup opens the packaged UI in the default browser. Close its console or press Ctrl+C to stop it. Closing a browser tab alone does not stop the server.+- `Cadmata.Desktop.exe` is the optional Windows window. Its existing form lifetime still owns the backend. It selects stable Evergreen, checks availability before backend startup, and presents Microsoft's download-page link plus Retry when unavailable. No installer runs automatically.+- Default browser sessions reuse the existing loopback/session-cookie protection. Embedded test hosts do not open browser tabs. Explicit `--no-browser --urls ...` hosting remains available.+- Publication retains executable names and merges shared dependencies with the existing compatibility guard. CLI discovery selects the platform's executable name. An explicitly supplied, hash-checked CAB remains an offline desktop packaging option; historical fixed-runtime packages remain readable.+- Public launch, bundle and platform documentation describes browser-first operation and the Windows-only wrapper.++## Qualification evidence++Evidence root: `artifacts/local/release-2-readiness/evergreen-webview/` (ignored).++- Clean CLI plus desktop publication succeeded. A first attempt caught incompatible stale `Aetheris.Cloth3D.dll` output; a clean rebuild resolved it without weakening the shared-file guard.+- Actual packaged `Cadmata.exe` launched Edge at an ephemeral loopback address with a blank, connected workspace. The test tab was closed and Ctrl+C stopped the owning server.+- Production package HTTP smoke served three UI assets and imported the canonical through-hole STEP. The same check passed after extracting the final ZIP into a fresh directory (`zip-http-smoke/`).+- Actual optional Evergreen window passed the existing interactive qualifier: gallery generation, download naming, standard views/orbit, composed-part generation, STEP import/export, invalid-import retention, and clean server shutdown following native close. `native-ui-qualified/qualification.json` records no frontend errors and `closeStoppedServer: true`. Runtime version observed: 155.0.4283.62.+- An empty runtime override, scoped to the test process, exercised the missing-runtime panel and Retry. Both checks stopped before backend creation; the native log records runtime unavailable. No system runtime was removed and no installer was launched.+- Linux WSL (`archlinux`), using .NET 10.0.13, ran the framework-dependent server from an unrelated working directory, served three production assets, imported the STEP as `Qualified`, and exited cleanly on SIGINT (`linux-smoke.json`). This is backend/asset evidence, not a Linux GPU or native-window qualification.+- Solution build: zero errors, 36 warnings. Fast kernel lane: 1,101 passed. Full serial solution gate: 6,028 passed, zero failed, two optional external PDF-renderer tests skipped. This includes the Firmament, complete STEP/kernel corpus, server startup/discovery and V8 geometry qualification. No test, compiler-server or Cadmata host remained after qualification.+- `git diff --check` passed. Modified launch, publication, diagnostic and discovery paths were reviewed for duplicate host copies, implicit browser downloads, authority duplication and unmanaged child lifetimes.++## Candidate and size++Local candidate: `browser-bundle/Aetheris-2.0.0-win-x64-browser-first.zip`.++| Payload | Previous local candidate | Browser-first candidate |+|---|---:|---:|+| ZIP bytes | 416,028,500 | 97,258,682 |+| Extracted bytes | 943,088,652 | 243,275,482 |++The ZIP is 76.6% smaller. Removing the private browser saves 667.4 MiB unpacked. The remaining payload includes self-contained .NET, the compiler, UI assets, optional Windows wrapper, existing Forge host, examples and notices; it contains no `webview2` directory or duplicate server publish directory. The unchanged Forge host/examples were copied from the preceding local candidate; application binaries were freshly published and current public docs copied from source.++SHA-256: `d7ac3770814dfb9763c7a374e8153487b7bb50c323dd9d6a789cfdbfe9c2415c`.++This is a locally qualified modified-source candidate, not a published release. No remote CI/publication was performed. macOS execution has not been tested. The browser/server separation permits a macOS-targeted server build without WebView2, but no macOS desktop package is claimed. The optional desktop edition still requires shared WebView2 on Windows; browser mode does not.++## Verdict++**Success.** The real default launch opens the existing browser; the optional Windows wrapper works with a shared runtime and explains a missing prerequisite without installing anything. The lean extracted package and full regression gate passed, including existing geometry qualifications. Linux server/asset/import behavior passed; macOS execution remains explicitly unqualified.diff --git a/docs/development/reports/2026-10/CADMATA-IMPORT-LOG-UX.md b/docs/development/reports/2026-10/CADMATA-IMPORT-LOG-UX.mdnew file mode 100644index 00000000..3c42389b--- /dev/null+++ b/docs/development/reports/2026-10/CADMATA-IMPORT-LOG-UX.md@@ -0,0 +1,67 @@+# Cadmata import diagnostic presentation++Result: **Success**. The user's McMaster screw now renders with a compact+diagnostic summary instead of a wall of importer explanations.++## Change++- One shared frontend component summarizes warnings and informational messages,+ keeps errors (including unfamiliar severities) visible, and downloads the+ complete original diagnostics as a text log with severity, code and source.+- The existing API client forwards structured response/failure diagnostics to+ the existing desktop session log. No new logger, service, diagnostic authority+ or importer filtering was added. Browser hosting retains the log download.+- Import qualification and display status remain visible. Public portable-app+ documentation describes both log paths. Obsolete inline-list styling was removed.++## Reproduction and evidence++The user supplied `91180A142_Medium-Strength Class 8.8 Steel Hex Head Screw.STEP`.+Input SHA-256: `a7deeaba1359ba67448d83bb8a95d8faa83b8f61bb09aaf44872bccc331818a9`.+The external file was read without modification and is not redistributed here.++The actual extracted WinForms/WebView2 application imported and rendered it.+The pane shows **32 warnings, 3 informational messages** and the log download.+All 35 original messages survived in both the downloaded log and the native+session log; none of their nonfatal message bodies appeared inline.++The screw remains **Degraded**, with 95 faces, 250 edges and 165 vertices.+Missing pcurves/recovery qualification remains unresolved; this presentation+change does not reclassify that engineering evidence. CLI `analyze --json`+before/after summaries, including bounds and qualification, compare equal.++The local candidate changes only production web assets. All 409 root executable+and DLL hashes match the qualified c279d98d bundle. Its metadata explicitly says+`modifiedSource: true`; it is a local qualification candidate, not a newly+published or hosted-qualified release.++Evidence under `artifacts/local/release-2-readiness/import-log-ux/`:++- `desktop-ui/qualification.json`, screenshot+ `desktop-ui/packaged-import-diagnostic-summary.png`, downloaded+ `desktop-ui/cadmata-diagnostics.log` and `desktop-ui/native-startup.log`.+- `binary-parity.json`, `screw-parity.json`, before/after CLI analyses and+ `local-hotfix-receipt.json`.+- The same desktop session passed canonical STEP export/reimport, invalid-file+ model retention, GPU rendering, native close and local-server shutdown, with+ no uncaught browser errors.++The existing portable qualifier accepts+`CADMATA_QUALIFICATION_DIAGNOSTIC_STEP` to run this optional noisy-import check+before its standard canonical import/export checks.++## Validation and scope++- Production TypeScript/Vite build passed; 101 frontend tests passed.+- Fast .NET lane: 1,089 passed.+- Full serialized solution lane: 6,008 passed, zero failed, two optional external+ drawing-renderer tests skipped (renderer not configured). FrictionLab has no+ discovered tests. These were the prescribed `--no-build` lanes; no C# source+ or managed binaries changed in this pass.+- Dependency-notice audit passed; `git diff --check` passed.+- Code-quality review found no duplicate diagnostic authority, new error-code+ allowlist, logger infrastructure or geometry/admission changes.++The local updated app is in `import-log-ux/Aetheris-win-x64/Cadmata.exe` beneath+the evidence directory above. The existing qualified extracted bundle was left+untouched. This pass does not publish a release or claim fresh hosted CI evidence.diff --git a/docs/development/reports/2026-10/CADMATA-WORKFLOW-FIXES.md b/docs/development/reports/2026-10/CADMATA-WORKFLOW-FIXES.mdnew file mode 100644index 00000000..2865b4b3--- /dev/null+++ b/docs/development/reports/2026-10/CADMATA-WORKFLOW-FIXES.md@@ -0,0 +1,71 @@+# Cadmata workflow fixes++Verdict: **Success**. All five reported workflows passed in the actual updated+Windows desktop application, using its bundled WebView2 and GPU renderer.++## Findings and repairs++| Report | Cause and repair |+| --- | --- |+| Cannot orbit into top/bottom | The shared Telos navigation adapter discarded pitch when the eye approached its up axis (`0.995` guard). Camera orbit now rotates the viewing frame with the eye, without a pole rejection. Exact standard views use the camera owner; Fit preserves orientation. |+| Gallery generates but does not display | ASP.NET serialized Forge artifact kinds numerically, while the UI searched for `StepAp242`. The Forge enum contracts now declare their canonical string serialization and still accept legacy numeric input. Generation also checks the preview result before reporting success. |+| Canonical download uses UUID | Gallery accepts a download export path, returns it with the artifact and carries it through preview into Canonical download. One browser filename helper preserves the product leaf name. The path is download metadata, never a server filesystem destination. Imports preserve their source filename; failed imports retain the prior model/name. |+| Startup/Refresh interference | No-argument desktop startup now opens a blank document. Explicit startup files remain supported. Successful STEP imports clear stale assembly source paths, so Refresh targets the current model. Blank Refresh stays disabled. |+| Obsolete modeling demo | Removed the two-body Boolean/translation controls. The replacement builds a bounded base plus centered raised block through ordinary Firmament Compose and the current section-stack planner. It exposes the generated source, rejects invalid dimensions and retains the real materialization receipt. Developer diagnostics are collapsed. Existing low-level API endpoints remain for compatibility. |++The demo submits Firmament source to the existing compiler; its actual+materialization receipt is `PrismaticSectionStack/Add`. It does not call the+document Boolean endpoints or introduce another geometry lowerer/language route.++## Evidence++All generated evidence is under+`artifacts/local/release-2-readiness/cadmata-workflow-fixes/`.++- Full solution build succeeded; final incremental build: zero errors/warnings.+- Fast .NET lane: 1,089 passed. Full serialized lane: **6,011 passed**, zero+ failed, two optional external PDF-renderer tests skipped. FrictionLab has no+ discovered tests. The final server/API test binaries were rebuilt before their+ position in the full serialized lane; its 70 server tests passed.+- Frontend: **104 passed**, production build and ESLint passed.+- Shared Telos: **19 passed**, including a full orbit through both poles,+ finite camera matrices, exact pole views and fit preserving direction.+- Final desktop receipt: `desktop-ui-final/qualification.json`.+ It proves blank startup, gallery rendering, `mounting-plate.step` download,+ composed-block rendering/Refresh, exact Top/Bottom/Isometric actions,+ canonical STEP export/reimport, failed-import model retention, native close+ and server shutdown. No uncaught browser errors.+- `desktop-ui-final/packaged-blank-startup.png`,+ `packaged-gallery-preview.png` and `packaged-composed-block.png` document the+ real UI. These are automated application interactions, not a human manual run.+- The supplied McMaster screw still renders as Degraded with all 35 diagnostic+ messages preserved in both logs and summarized in the UI.+- The demo's generated program was independently compiled and inspected through+ the real CLI: one enclosed manifold, 11 planar faces, 24 edges, 16 vertices,+ bounds `[-40,-25,0]..[40,25,20]` mm. See `composed-block-build.json` and+ `composed-block-analysis.json`.+- The gallery's Canonical reexport is Qualified: 46 faces, 116 edges and+ 76 vertices (`gallery-reexport-analysis.json`).+- Kernel binaries remain byte-identical to the existing qualified bundle. Only+ the desktop, server and Forge protocol managed libraries plus frontend assets+ were overlaid into the local test candidate. No geometry algorithm, existing+ Firmament fixture or dependency version changed.++The Telos producer was rebuilt and its local-package lock identity refreshed+through TSPack; the lock diff changes only the local Telos identity/references.+The existing fixed local-dependency build tool was used after the older PATH+tool failed on the already-known peer-range limitation. No dependency cache was+edited by hand and no other repository was changed.++Public portable-app documentation now describes blank startup, standard views,+gallery export naming and the composed-block demo. Code-quality review removed+obsolete Boolean UI state/styles and retained one camera and filename authority.+Dependency notices and `git diff --check` pass.++## Local candidate++`Aetheris-win-x64/Cadmata.exe` under the evidence directory contains the updated+frontend and compiled application libraries, reusing the qualified runtime.+Metadata explicitly marks it as modified local source. `local-candidate-receipt.json`+records changed library hashes and kernel parity. The original extracted bundle+is untouched. This is not a new published release or a claim of fresh hosted CI.diff --git a/docs/development/reports/2026-10/PAPERCLIP-ANALYTIC-TRIMS.md b/docs/development/reports/2026-10/PAPERCLIP-ANALYTIC-TRIMS.mdnew file mode 100644index 00000000..8ed62f18--- /dev/null+++ b/docs/development/reports/2026-10/PAPERCLIP-ANALYTIC-TRIMS.md@@ -0,0 +1,38 @@+# Exact analytic paperclip trims++2026-10-24. Follow-up to the paperclip interchange fix and browser-first candidate.++## Cause and repair++The supplied `maximum-paperclip.step` was 53,884 bytes, versus 6,555 bytes for the earlier AP242 specimen. Its solid still had three toroidal faces, four cylinders, two planar caps, and exclusively circular/linear 3D edges. Import had populated missing UV trims through the general periodic-surface fitter, producing 21 cubic spline definitions and 646 Cartesian points. Export serialized those fitted trims, including straight isoparametric boundaries.++`BrepPcurveRecovery` now recognizes cylinder generators and rings, plus the major/minor circles of regular ring tori, before fitting. Support/curve identities establish the affine UV parameterization using rounding-scale geometric checks independent of the import tolerance. Signed angular spans come from circle orientation and are retained across seams and multiple turns. The existing independent lift validator remains authoritative. Other curves retain the general recovery path; existing source-supplied trims are preserved.++No 3D geometry, construction winding, tolerance policy, parser route or export option was changed. Public WireForm documentation now explains analytic trim derivation and source-trim retention.++## Evidence++Ignored evidence: `artifacts/local/release-2-readiness/analytic-paperclip-trims/`.++- Eight analytic tests cover four edge/support families in translated, rotated frames with both orientations, negative starting parameters and spans exceeding a full turn. A ninth rejects off-support and oblique cases, including a radius mismatch smaller than the import tolerance.+- The compiler-backed paperclip test exercises two import/export cycles. It preserves nine faces, 15 edges, eight vertices, all 30 pcurves and explicit seams, with no spline/polyline representation. Reconstruction deviation remains below `1e-10 mm`.+- Real CLI build plus `canon` emits a **10,955-byte** STEP with 28 linear UV uses and two planar conic uses. Maximum reported lift deviation is approximately `3.92e-14 mm`.+- Independent OCCT comparison against the supplied file reports both shapes valid, one solid and nine faces, identical bounds, and matching volume/area within `1e-9`. Result: approximately **75.16190668032 mm³**, **302.21842304808 mm²**. The user's input files were not modified.+- The updated packaged Cadmata server served production assets, imported the paperclip as `Qualified`, and exported it through the real definition-export endpoint: **10,955 bytes**, no splines, explicit seam curves. Its STEP is byte-identical to the CLI output (SHA-256 `82cf4b33274646807dfdb139728030959f36673d0c0a34ff99777be59a329a2c`), so the independent geometry comparison covers both paths. The server was stopped afterward. This is API/package evidence; no new SolidWorks or native-window interaction was claimed.+- The first complete core run passed 1,262 checks and exposed three expected NIST serialization-hash changes. Snapshot comparison confirmed every non-hash field unchanged. Only CTC-03, FTC-09 and STC-09 changed; their Windows hashes and independently measured Linux overrides were refreshed.+- Bounded Linux qualification: **40 core/interchange checks and one compiler-backed paperclip round-trip passed**, including the three NIST overrides. Fast Windows kernel lane: **1,110 passed**.+- Solution build passed with zero errors and eight warnings. Full serial Windows solution qualification passed: **6,038 passed, zero failed, two existing optional PDF-renderer skips**, including the complete kernel corpus, Firmament, server and V8 geometry suites. `git diff --check` passed.++## Local candidate++`Aetheris-2.0.0-win-x64-analytic-trims.zip`, **97,259,503 bytes**, SHA-256:++`3a00de470864fee62a8765b5689616a1d1236658db364c882faa6eb4be9aa280`++This local modified-source candidate copies the preceding qualified browser-first bundle, replaces the changed core assembly with its matching 2.0.0 assembly version, and updates the WireForm guide. It retains the existing browser-first launch and carries no private WebView2 runtime. Package HTTP/import/export checks use this candidate. No public release or hosted CI run was performed.++Regenerated output is `paperclip-cadmata-export.step`. Already supplied spline pcurves are deliberately retained during import; this fix prevents generating redundant fits when trims are missing. It does not add a general imported-spline simplifier, extend torus support to horn/spindle cases, or claim that all analytic intersections have linear UV curves.++## Verdict++**Success.** The motivating compiler-to-Cadmata export no longer fits splines to analytic paperclip trims. Geometry and seam spans are independently qualified, the full Windows gate and bounded Linux gate pass, and the replacement archive contains the qualified core assembly. Owned test servers and build/test hosts exited. The user's pre-existing browser server was left running; use a fresh extraction of the new candidate to launch the fixed application. Nothing was published remotely.diff --git a/docs/development/reports/2026-10/PAPERCLIP-STEP-EXPORT-FIX.md b/docs/development/reports/2026-10/PAPERCLIP-STEP-EXPORT-FIX.mdnew file mode 100644index 00000000..8fee7fee--- /dev/null+++ b/docs/development/reports/2026-10/PAPERCLIP-STEP-EXPORT-FIX.md@@ -0,0 +1,48 @@+# Paperclip STEP export fix++2026-10-24. Follow-up to [the controlled interchange investigation](PAPERCLIP-STEP-INTERCHANGE-AUDIT.md).++## Changes++- Corrected Straight/Bend WireForm side and terminal boundary winding at construction. Analytic surfaces, dimensions, topology counts and feature identities are preserved.+- Circular and hyperbolic advanced-face edges now reference their underlying analytic curves instead of forbidden 3D `TRIMMED_CURVE` wrappers. Vertices, edge sense and qualified pcurves retain the intended bounds. The public `EmitFullCircleTrimmedCurves` property remains for source compatibility and has no effect; its internal plumbing and production caller were removed.+- Fixed periodic pcurve rebinding exposed by that correction: inferred circle/ellipse parameters may move by a whole turn at a seam. The decoder aligns the pcurve domain by whole periods only when both endpoints agree within `1e-8` radians. Polynomial knot domains move by the same amount. Geometry, weights, controls, provenance and use sense are preserved; mismatched spans still fail validation.+- Stabilized symmetric SurfaceMeshIR quad diagonal selection against rounding-scale platform differences. The shortest valid diagonal remains preferred; ties within `1e-12 × max(1, diagonal length)` use a fixed split. No support or vertex changes.+- Added raw construction and raw serialized-cap winding checks, analytic-basis checks, periodic-seam tests and diagonal-tie tests. Improved the 3DM recovery test's failure diagnostics.++No import setting, SolidWorks workaround, approximation, alternate exporter route, native dependency or geometry feature was added.++## Geometry and application witnesses++The current CLI validates and builds `fixtures/Canonical/WireForm/paperclip.firmament`. Independent OCCT inspection preserves **75.1619066803201 mm³** volume, **302.218423048075 mm²** area, Y bounds **-4.5 to 20.5 mm**, nine faces and one solid. Each toroidal bend retains the intended `[0, π]` major-angle interval.++The fresh compiler output was opened in SolidWorks Design Professional for Makers 2026 SP3.0. Import Diagnostics was declined and global settings were unchanged. It displays the correct paperclip as one solid. SolidWorks Mass Properties reports **75.16 mm³** and **302.22 mm²** at its existing two-decimal display precision. Existing user files and documents were not saved or changed. This qualifies local import and mass properties, not every downstream SolidWorks operation.++An isolated local bundle is prepared at `artifacts/local/release-2-readiness/paperclip-fixed-bundle/Aetheris-win-x64/`, with `Aetheris-2.0.0-win-x64-paperclip-fixed.zip` beside it. It preserves the previously qualified Cadmata bundle and replaces only the two changed kernel assemblies and their matching symbols when present. Its real packaged CLI builds the paperclip with no diagnostics and emits byte-identical STEP to the source-built CLI (`f3d55cbfff0c9725b0ea3b845127f43f72c05a67854dde1a6c82015d4fb13c73`). Skia/PDFium remain absent. The ZIP has CRC integrity checked and SHA256 `fb8b6e879d69b6753a7ad0828e5171a5951e4b7b5062ea2fe4226ec67de6b967`. The existing running bundle and published artifacts were not modified. The new desktop bundle was not separately relaunched; this pass exercises its packaged CLI and preserves the previously qualified desktop/frontend binaries.++## Compatibility qualification++- The full gate exposed a 3DM recovery regression and imported-hole/rounded-plateau pcurve regressions. Whole-period alignment closes them; focused reruns pass all 27 recovered bodies, the real imported-hole CLI workflow and 28 related Firmament tests.+- Updated 16 Windows NIST serialization hashes. All other snapshot fields, including admission, topology and diagnostics, are unchanged. The three existing Linux-specific overrides were measured under Linux and updated; the remaining platform hashes agree.+- The isolated prior kernel first matched the frozen V8 mesh reference. All 21 current definition bodies then matched its surfaces, curves, trims, vertices and topology within the existing `1e-9` bound; the largest numeric difference is `1.4210854715202004e-14`. All 171 world placements are preserved. Four display samplings changed with legal analytic edge bases; the diagonal tie rule also changes display connectivity. The numeric display reference was refreshed only after this exact-body comparison.+- Windows/Linux current V8 mesh indices and array lengths agree exactly. Maximum position difference is `1.0125233984581428e-13 mm`; maximum normal-component difference is `2.2668732169162098e-10`. The existing `1e-9` test bounds were retained.+- Linux qualification uses the real .NET 10.0.401 test platform and 10.0.13 runtime in an ignored artifact directory, through WSL. All 32 selected kernel/interchange tests and the V8 geometry test pass. This is a bounded Linux gate, not a full Linux suite claim.++Raw logs, the prior/current V8 probe, numeric comparisons, SolidWorks observations and STEP specimens remain under ignored `artifacts/local/release-2-readiness/paperclip-interchange-audit/`.++## Scope and remaining limits++This closes the circular WireForm interchange defect. It is not a complete STEP schema conformance audit. The pre-existing partial B-spline edge wrapper branch is unchanged: simply deleting those wrappers would lose trim intervals in the current spline importer. Exact domain-bounded spline export/import needs separate qualification. The pcurve's own 2D `TRIMMED_CURVE` is legal and remains supported.++The independent-bounds discrepancy noted in the investigation is also unchanged. This pass uses independently measured geometry bounds rather than claiming that the CLI's generic analytic bounds have been repaired.++## Final gate++- `dotnet build Aetheris.slnx -c Release -m:1 -nr:false -p:UseSharedCompilation=false`: passed, zero warnings/errors on the final incremental build.+- Fast kernel lane, `Category!=SlowCorpus`: **1,101 passed**, zero failures.+- Complete `dotnet test Aetheris.slnx -c Release --no-build -m:1 -nr:false -- RunConfiguration.MaxCpuCount=1`: **6,027 passed**, **2 skipped**, zero failures across 20 assemblies. The skips are the existing optional PDF-rasterizer cases.+- Bounded Linux gate: **33 passed**, zero failures, including NIST snapshots, seam/quad checks and the V8 geometry reference.+- `git diff --check`: passed. Modified code was checked for global winding reversal, new parser/export routes, source mutation, tolerance weakening and lost pcurve provenance; none was introduced.+- Controlled build/test hosts exited; no persistent .NET build/test process is required by the fix.++**Verdict: Success for the reported paperclip blocker.** Fresh real-path STEP imports correctly in SolidWorks, its analytic geometry is preserved, the broader regressions exposed by legal edge emission are closed, and the full Windows gate passes. This does not assert that the separate spline-export and generic analytic-bounds limits above are fixed, or that the local candidate has been published.diff --git a/docs/development/reports/2026-10/PAPERCLIP-STEP-INTERCHANGE-AUDIT.md b/docs/development/reports/2026-10/PAPERCLIP-STEP-INTERCHANGE-AUDIT.mdnew file mode 100644index 00000000..765991ad--- /dev/null+++ b/docs/development/reports/2026-10/PAPERCLIP-STEP-INTERCHANGE-AUDIT.md@@ -0,0 +1,78 @@+# Paperclip STEP interchange investigation++2026-10-24. Diagnostic phase; no production exporter or geometry changes were made during this investigation. The subsequent implementation and qualification are recorded in [Paperclip STEP export fix](PAPERCLIP-STEP-EXPORT-FIX.md).++## Verdict++**Success for diagnosis.** The supplied Aetheris AP242 has inconsistent boundary winding. Reversing its boundary walks, without changing any surface, radius or coordinate, restores the expected paperclip in SolidWorks Design Professional for Makers 2026 SP3.0. Changing only the illegal edge basis references does not restore it. This isolates winding as the immediate cause of the observed complementary torus trims.++The original also contains a separate STEP conformance defect: three advanced-face edges reference `TRIMMED_CURVE` rather than an admitted underlying curve. A successful display in another reader does not qualify either defect away. A permanent fix still needs implementation and regression qualification.++## Evidence++Inputs, preserved unchanged:++| Input | SHA256 |+| --- | --- |+| `Downloads/maximum-paperclip-ap242.step` | `51C64F91007074CAC28C500E0CFAAC014E305491A368378AD65003EF5D526E1F` |+| `Downloads/maximum-paperclip-ap214-sw.STEP` | `2CE7A4235BABFBE9EDC408206CFAD3DDEFB70B166AC1469D49C23763C5C8203D` |++Generated evidence is under ignored `artifacts/local/release-2-readiness/paperclip-interchange-audit/`: CLI analysis JSON, `audit.py`, input hashes, `occt-comparison.json`, `torus-domain-comparison.json`, and three controlled STEP variants. Independent inspection used isolated cadquery-ocp 7.7.2 installed only in that artifact directory; no production dependency was added.++| OCCT measurement | Original AP242 | Supplied SW AP214 |+| --- | ---: | ---: |+| Faces | 9 | 16 |+| Torus faces | 3 | 6 |+| Y bounds, mm | -4.5 to 20.5 | 0 to 15 |+| Signed volume integral, mm³ | +75.1619066803201 | -15.9442802737839 |+| Surface area, mm² | 302.218423048075 | 302.218423048075 |++The negative integral is an orientation warning, not a physically meaningful negative material volume. The original nominal volume independently follows from a 0.5 mm wire radius and centerline length `58 + 12π` mm, giving `75.1619066803201 mm³`.++Both files retain the same analytic torus centers, axes and radii (major radii 3, 4 and 5 mm; minor radius 0.5 mm). OCCT reconstructs the original major-angle intervals as `[0, π]`, but the SW result as `[π, 2π]`. The latter splits each torus into two minor-angle halves. At the outer bend, the major-arc midpoint changes from `(5, 20, 0.5)` to `(5, 10, 0.5)` mm. This is a different trim domain, not a missing torus implementation or a changed torus equation.++## Controlled SolidWorks experiment++Opened local diagnostic copies through the existing SolidWorks UI. Declined the optional Import Diagnostics operation for each copy; did not alter global import settings. Existing user documents and source files were not saved or changed. Diagnostic imports remain unsaved.++| Variant | Exact intervention | Observed SolidWorks result |+| --- | --- | --- |+| Existing original import | None | Bent-back, overlapping surface appearance matching the reported failure |+| `legal-basis-only.step` | Three `EDGE_CURVE` references changed to their underlying `CIRCLE` entities | Still broken |+| `winding-only.step` | Reverse each `EDGE_LOOP` order and invert each `ORIENTED_EDGE` sense | Normal paperclip, one reported solid body |+| `legal-basis-and-winding.step` | Both interventions | Normal paperclip, one reported solid body |++These are direct UI witnesses, not SolidWorks mass-property or re-export qualification. Independent OCCT inspection of every corrected variant preserves the original volume, area and bounds. No claim is made that all downstream SolidWorks engineering operations are qualified.++## Concrete defects and ownership++### Boundary winding++Original edge `#21` is a forward circle about +Y. End-cap face `#148` has a plane normal of -Y, a forward oriented edge, a true outer-bound orientation, and true face same-sense. Its boundary therefore disagrees with its declared outward normal. The other end cap has the analogous issue.++The STEP topology convention requires the cross product of the face normal with the boundary tangent to point into the face. See the [geometric and topological representation resource, face and face_surface semantics](https://www.steptools.com/stds/smrl/data/resource_docs/geometric_and_topological_representation/sys/5_schema.htm).++The relevant source owner is `Aetheris.Kernel.Firmament/Materializer/WireForm.cs`, especially side-face and cap loop construction around lines 411–419. Correct construction should agree with analytic surface normals. Do not globally reverse all exports: the isolated specimen reversal is causal evidence, not a safe general production algorithm.++### Advanced-face edge basis++Edges `#36`, `#76` and `#114` reference trimmed curves `#35`, `#75` and `#113`. The [advanced_face EXPRESS restriction](https://www.steptools.com/docs/stp_aim/html/t_advanced_face.html) admits LINE, CONIC, POLYLINE, SURFACE_CURVE and B_SPLINE_CURVE as edge geometry; TRIMMED_CURVE is outside that set.++The exporter owner is `Aetheris.Kernel.Core/Step242/Step242Exporter.cs`, around line 1048, which deliberately emits trimmed curves for partial circles. Review other trimmed-basis emissions at the same owner. Keep true analytic circles and edge orientation; use conforming surface-local pcurves/seam representations where periodic branch information is needed.++### Qualification gaps++- Both supplied files receive `Qualified` from the current Aetheris CLI analysis; OCCT also reports both valid. Neither result proves the requested shape survived interchange.+- [OCCT STEP import normally runs shape processing](https://github.com/Open-Cascade-SAS/OCCT/blob/master/dox/user_guides/step/step.md). Requesting an unconfigured post-processing sequence gave the same measurements here, but translation itself can reconstruct topology. This is not a raw, repair-free conformance check.+- The original contains no pcurves. That alone is not established as a conformance violation; explicit periodic-face trim information is an exchange robustness consideration.+- Aetheris CLI bounds for the original omit the wire-radius contribution at the bend apex (Y -4 to 20 rather than -4.5 to 20.5). Bounds in the table come from independent OCCT inspection.+- Fusion/ACIS behavior is user-reported in this investigation; it was not independently rerun. SolidWorks import and the OCCT comparison were rerun.++## Permanent repair boundary++1. Correct WireForm boundary winding at construction and add a raw exported-loop/normal witness before reimport can hide it.+2. Emit conforming advanced-face edge bases; test partial arcs, full circles and periodic seams without losing intended arc selection.+3. Qualify paperclip volume, actual bounds, topology and analytic surfaces through export/reimport and real SolidWorks import. Preserve original analytic geometry.+4. Run the relevant full .NET regression lane when production code changes. No .NET build/test rerun was warranted for this investigation-only report; no prior test totals are claimed as new evidence.++SolidWorks could diagnose malformed input more helpfully, but the immediate repair belongs in our emitted topology. This investigation does not establish a general Parasolid torus defect.diff --git a/docs/public/cadmata/overview.md b/docs/public/cadmata/overview.mdindex ffbc0092..f448c6dc 100644--- a/docs/public/cadmata/overview.md+++ b/docs/public/cadmata/overview.md@@ -2,7 +2,7 @@Cadmata is Aetheris's interactive 3D engineering presentation and inspection surface. It displays geometry, supports selection and feature association, and presents semantic PMI—datums, dimensions, GD&T, and engineering notes—with filtering and inspection context.-Use `aetheris view model.firmament` or `aetheris view part.step` from the qualified Windows bundle. The standalone .NET tool package does not contain Cadmata. Cadmata is not primarily a traditional drawing system: static drawing and shop-floor projection are downstream presentations of the semantic model.+Use `aetheris view model.firmament` or `aetheris view part.step` from the qualified Windows bundle to open the UI in your existing browser. `Cadmata.exe` starts a blank browser session; `Cadmata.Desktop.exe` is an optional Windows window using shared Evergreen WebView2. The normal bundle contains no browser engine. The standalone .NET tool package does not contain Cadmata. Cadmata is not primarily a traditional drawing system: static drawing and shop-floor projection are downstream presentations of the semantic model.Cadmata opens AP242 STEP assemblies as a product tree with shared part definitions and placed occurrences. The STEP viewer's import control is the normal entry point; internal fixture endpoints are reserved for automated qualification and are not part of the viewer controls.@@ -11,4 +11,8 @@ spacing, and analytic axis spacing. See [measurements in Cadmata and Helios](meafor reference replacement, world-coordinate deltas, units, approximation labels andthe supported geometry boundary.-Preview 3 qualification is Windows x64. See [PMI presentation](pmi.md) and the [support matrix](../reference/supported-features.md).+The packaged desktop convenience window is Windows-only. The .NET server and web+UI are separate from that shell: a server built for Linux or macOS can serve the+same UI to a browser. This is not a native macOS/Linux desktop-app release claim;+WebView2 is not used on those platforms. See [launch requirements](portable-windows.md),+[PMI presentation](pmi.md) and the [support matrix](../reference/supported-features.md).diff --git a/docs/public/cadmata/portable-windows.md b/docs/public/cadmata/portable-windows.mdindex efa909ca..66674ea3 100644--- a/docs/public/cadmata/portable-windows.md+++ b/docs/public/cadmata/portable-windows.md@@ -1,41 +1,88 @@-# Cadmata — portable Windows application+# Cadmata — browser-first Windows bundleDownload `Aetheris-2.0.0-win-x64.zip` from[Aetheris releases](https://github.com/yuechen-li-dev/Aetheris/releases).Extract the entire ZIP to a local folder. Open `Aetheris-win-x64` and run-**Cadmata.exe**. The CLI and desktop share their CAD and .NET libraries in this-folder; keep the `webview2` directory beside the executable.+**Cadmata.exe**. It starts a local CAD session and opens your default browser.+It uses your existing browser; the normal ZIP contains no private Chromium,+Edge or WebView2 runtime. No WebView2 installation is needed for this mode.-The included mounting block opens automatically. Use STEP 242 Viewer to open-your own STEP file and **Download Canonical 242** to save a canonical STEP file.-Close the window to exit; reopen Cadmata.exe to start another session.+```powershell+.\Cadmata.exe+# Or open a part directly:+.\aetheris.exe view .\testdata\firmament\inline-step\canonical-through-hole.step+```++Cadmata opens a blank workspace. Use STEP 242 Viewer to open your own STEP file,+or generate a part in **Product Gallery**. Set **Export filename** before+generation; the part appears in the viewport and keeps that name for downloads.+**Download Canonical 242** keeps the imported or generated product's filename;+browser downloads use the filename portion of an export path.+Close the server console window, or press Ctrl+C there, to end the session.+Closing only the browser tab does not stop the local server. Reopen Cadmata.exe+to start another session. `Cadmata.exe --no-browser --urls http://127.0.0.1:5090`+starts an explicitly addressed server without opening a browser.++Left-drag to orbit freely through the top and bottom orientations, right-drag+or Shift-drag to pan, and scroll to zoom. **Standard view** selects exact top,+bottom, front, back, left, right or isometric views. **Refresh Display Data**+refreshes the currently loaded model and is disabled in an empty workspace.++The **Modeling Demo** builds one composed part from a rectangular base and a+centered raised block. Set their dimensions in millimetres and select **Build+composed part**. It uses the same Firmament Compose planning and STEP export as+the compiler; it does not run the retired two-body Boolean demo. The raised+block must fit within the base footprint. Expand **Firmament source** to inspect+the program used to construct the part.Windows 11 x64 is the initial qualification target. A WebGPU-capable GPU/driveris recommended. Three Telos uses automatic CIR where qualified and meshotherwise. A browser without WebGPU uses the labeled existing WebGL fallback;-initialization/device failures show a diagnostic. The ZIP includes .NET,-ASP.NET, WindowsDesktop and fixed WebView2 153.0.4234.48. No SDK, Node, browser-runtime installation, terminal or internet connection is needed for local CAD.-Run from a local disk; network/UNC folders are unsupported by fixed WebView2.-Use an extraction path containing ASCII characters, such as `C:\Cadmata`;-spaces are supported. A CJK extraction path failed WebView2's `dxil.dll` load-on the qualification machine. If the viewport reports Windows Error 87,-close Cadmata and extract the entire ZIP to an ASCII path before reopening.+initialization/device failures show a diagnostic. The ZIP includes the .NET+runtimes and production UI assets. No SDK, Node or internet connection is needed+for local CAD in an existing browser. Extract into a fresh local directory when+updating, rather than merging old browser/runtime files into the new package.++## Optional desktop window++Run **Cadmata.Desktop.exe** to use a dedicated Windows window instead of a browser+tab. It uses the shared Microsoft Evergreen WebView2 Runtime. If that runtime is+missing, it offers Microsoft's download page and a Retry button. Installation+is explicit; Cadmata never downloads or installs a browser automatically.+Normal Cadmata.exe does not need this prerequisite. Closing the optional desktop+window stops its local server.++An explicitly packaged offline desktop edition may carry a `webview2` directory.+Keep that directory intact and update that edition to receive browser fixes.+Fixed-runtime editions require a local ASCII extraction path; spaces work,+but a CJK path previously failed loading the runtime's `dxil.dll`. Network/UNC+locations are unsupported for that fixed runtime. These restrictions do not+describe the normal browser-first package.The executable is unsigned. Windows may display an unknown-publisher warningfor a downloaded ZIP. The portable application has no installer or automatic updater.-Download a newer ZIP to update the bundled browser/security runtime.+Your browser and shared Evergreen runtime receive their own updates; download+a newer ZIP to update Cadmata itself.-About Cadmata shows the version and source identity. Open diagnostic log shows+In the optional desktop window, About Cadmata shows the version and source identity. Open diagnostic log showsthe current session log. Logs and disposable browser profiles live under`%LOCALAPPDATA%\Aetheris\Cadmata`; the extracted application is read-only duringnormal use. Twenty diagnostic logs are retained. Exports use browser downloads,-and model state is session-local. Reopening loads the included sample again.+and model state is session-local. Reopening starts a blank workspace. An explicit+STEP or Firmament file argument still opens that file at startup.++STEP import keeps its qualification status visible. Warnings and informational+messages are summarized as counts; errors remain visible with their explanations.+Use **Download diagnostic log** beside the summary to save all messages, including+their severity, code and source. The same API diagnostics are recorded in the+desktop session log, accessible through **Open diagnostic log**. This presentation+does not change import tolerances, qualification or geometry.Aetheris is AGPL-3.0-only; the managed Copeland compiler retains GPLv3.See LICENSE and licenses/ for bundled dependency notices.CORRESPONDING-SOURCE.md supplies exact source revisions and downloadable sourcearchives for both projects. Source: https://github.com/yuechen-li-dev/Aetheris.-BUILD-METADATA.json identifies the source revision, modifications and browser pin.+BUILD-METADATA.json identifies the source revision, modifications, default browser+presentation and optional desktop runtime mode. Evergreen has no packaged browser pin.A package marked `modifiedSource` is a local qualification candidate, not apublished source-identical release.diff --git a/docs/public/firmament/wire-form.md b/docs/public/firmament/wire-form.mdindex ff7183a5..31fa1e9b 100644--- a/docs/public/firmament/wire-form.md+++ b/docs/public/firmament/wire-form.md@@ -33,6 +33,9 @@ Circular area times total length gives volume; density from the Material DB giveThe centerline lowers to explicit line and circular-arc AIR, then to exact circular Sweep geometry. Straights become cylinders, bends become toroidal patches, and open terminals become planar caps. Canonical WireForms have no rational B-spline surfaces and no faceted fallback. Both terminals retain position, tangent/frame, and section diameter.+STEP export retains these analytic surfaces and circular edge bases. Face boundaries follow their outward normals, so a downstream CAD reader receives the intended bend side without needing to repair the wire's winding.+When STEP edges lack surface-parameter trims, import derives exact linear trims for cylinder generators and rings, and torus major and minor circles. Straight/Bend wire forms do not need fitted B-spline trim curves; seam boundaries retain their full angular spans. Existing source trim curves are preserved rather than rewritten.+Winding generators extend wire forming without weakening the exact Straight/Bend route. `Helix` authors a cylindrical helix from `Radius`, `Turns`, either `Pitch` or `Height`, explicit `Handedness`, and an optional stable `StartPhase`. If both Pitch and Height are supplied they must agree with `Height = Turns × Pitch`. The compiler derives the missing value, exact helix length, terminal position/tangent/transported frame, turn clearance, volume, and mass. `AxisCoil` remains accepted as a compatibility spelling and lowers to the same semantic operation. The axis is derived from the current wire state rather than specified as an independent field.```firmamentdiff --git a/docs/public/release-bundle.md b/docs/public/release-bundle.mdindex 902a9d3f..4675b04b 100644--- a/docs/public/release-bundle.md+++ b/docs/public/release-bundle.md@@ -2,12 +2,17 @@This bundle is the `win-x64` product distribution. Run commands from the `Aetheris-win-x64` directory.-Double-click `Cadmata.exe` in that directory to open the desktop application.-It hosts its own local service on a temporary loopback port and closes that-service with its window. The CLI and desktop share one set of .NET and CAD-libraries. The `webview2` directory contains the desktop's pinned offline browser;-keep it beside the executable. `Cadmata.Server.exe` is the explicit headless-server entry point, not the desktop application.+Double-click `Cadmata.exe` to open Cadmata in your existing default browser.+It starts a local service on a temporary loopback port. Close the server console+or press Ctrl+C there to stop it; closing the browser tab alone does not end the+session. `Cadmata.exe --no-browser --urls http://127.0.0.1:5090` is the explicit+headless entry point.++`Cadmata.Desktop.exe` is the optional dedicated Windows window. It uses the+shared Evergreen WebView2 Runtime and owns its server lifetime. Normal browser+mode does not need WebView2. The normal ZIP includes no browser engine, and+neither launcher installs one automatically. Both share the CAD and .NET+libraries in the bundle. See [Cadmata launch and runtime requirements](cadmata/portable-windows.md).```powershell.\aetheris.exe --helpdiff --git a/fixtures/Canonical/EditableV8/README.md b/fixtures/Canonical/EditableV8/README.mdindex abf277f2..bf803fce 100644--- a/fixtures/Canonical/EditableV8/README.md+++ b/fixtures/Canonical/EditableV8/README.md@@ -1,14 +1,15 @@# Editable V8 geometry reference`geometry-reference.expected.json` retains the original implementation's 171-binding names, 21 mesh fingerprints and solved world matrices. Its source hash-and implementation commit identify the pre-refactor baseline.+binding names and solved world matrices, together with 21 qualified display-mesh+fingerprints. Its source hash and implementation commit identify the design's+pre-refactor provenance; `meshReferenceRevision` identifies its display projection.-`geometry-reference.meshes.zip` recovers the numeric data behind those existing-fingerprints. Each entry is named `<original SHA-256>.bin` and contains+`geometry-reference.meshes.zip` contains the numeric data behind those qualified+fingerprints. Each entry is named `<SHA-256>.bin` and containslittle-endian position and normal arrays (Int32 length, then Float64 elements),followed by indices (Int32 length and elements). Signed zero is normalized.-The test verifies each entry against the unchanged original fingerprint.+The test verifies each entry against its declared fingerprint.The numeric golden is necessary because a byte hash cannot distinguish geometrychanges from platform math roundoff. Windows/Linux comparison on 2026-10-16 found@@ -16,9 +17,17 @@ identical array lengths and indices, maximum position delta `1.013e-13 mm`, andmaximum normal-component delta `2.267e-10` (spring normals). The live test allows`1e-9 mm` per position component and `1e-9` per normal component, requires finitevalues, and compares indices exactly. World matrices retain their `1e-9` bound.-No production geometry or original fingerprint was changed.+The analytic-edge export correction on 2026-10-24 changed display sampling on four+definitions. Symmetric quad diagonals also gained a rounding-scale deterministic+tie-break. Before refreshing these display fingerprints, all 21 definitions'+surfaces, curves, trim bindings, vertices and topology were compared with the prior+qualified kernel within `1e-9`; all 171 world matrices were preserved. The prior+kernel's meshes first passed the original frozen reference. The new Windows and+Linux meshes have identical indices and array lengths, with maximum position+and normal differences within the existing component bounds. No design dimensions+or exact construction geometry changed.-To recover the archive, run the demo at the original implementation commit with+To recover the archive, run the demo at the qualified current revision withdefault `V8Spec` (see the JSON's `reproduction` field), then from the currentrepository root:@@ -27,8 +36,8 @@ python scripts/freeze-editable-v8-reference.py path/to/baseline.mesh.json```The command writes under ignored `artifacts/local/v8-ci/`. It refuses any input-whose meshes do not exactly match all original fingerprints; it cannot rebaseline-changed geometry. The checked-in archive was recovered from the Windows baseline-with all 21 original hashes verified. It is a compressed durable regression golden,+whose meshes do not exactly match all declared fingerprints; it cannot rebaseline+changed geometry. The checked-in archive uses the qualified Windows projection+with all 21 hashes verified. It is a compressed durable regression golden,not a per-run mesh export. Its full numeric arrays permit tolerance comparisonswithout the boundary failures introduced by rounding and hashing floats.diff --git a/fixtures/Canonical/EditableV8/geometry-reference.expected.json b/fixtures/Canonical/EditableV8/geometry-reference.expected.jsonindex 9108be52..f4f2834a 100644--- a/fixtures/Canonical/EditableV8/geometry-reference.expected.json+++ b/fixtures/Canonical/EditableV8/geometry-reference.expected.json@@ -6,7 +6,7 @@"bindings": [{"name": "Rod1",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.7071067811865477,-0.7071067811865477,@@ -50,7 +50,7 @@},{"name": "PistonSkirt1",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865477,-0.7071067811865477,@@ -72,7 +72,7 @@},{"name": "PistonLugA1",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,-0.7071067811865477,@@ -94,7 +94,7 @@},{"name": "PistonLugB1",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,-0.7071067811865477,@@ -138,7 +138,7 @@},{"name": "Cylinder1",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,-0.7071067811865476,@@ -160,7 +160,7 @@},{"name": "Head1",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,-0.7071067811865476,@@ -226,7 +226,7 @@},{"name": "IntakeRetainer1",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -314,7 +314,7 @@},{"name": "ExhaustRetainer1",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -358,7 +358,7 @@},{"name": "Rod2",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.45919488658892854,0.8883355537917986,@@ -402,7 +402,7 @@},{"name": "PistonSkirt2",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865477,0.7071067811865477,@@ -424,7 +424,7 @@},{"name": "PistonLugA2",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,0.7071067811865477,@@ -446,7 +446,7 @@},{"name": "PistonLugB2",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,0.7071067811865477,@@ -490,7 +490,7 @@},{"name": "Cylinder2",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,0.7071067811865476,@@ -512,7 +512,7 @@},{"name": "Head2",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,0.7071067811865476,@@ -578,7 +578,7 @@},{"name": "IntakeRetainer2",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -666,7 +666,7 @@},{"name": "ExhaustRetainer2",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -710,7 +710,7 @@},{"name": "Rod3",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.8883355537917985,-0.4591948865889283,@@ -754,7 +754,7 @@},{"name": "PistonSkirt3",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865477,-0.7071067811865475,@@ -776,7 +776,7 @@},{"name": "PistonLugA3",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,-0.7071067811865475,@@ -798,7 +798,7 @@},{"name": "PistonLugB3",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,-0.7071067811865475,@@ -842,7 +842,7 @@},{"name": "Cylinder3",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,-0.7071067811865476,@@ -864,7 +864,7 @@},{"name": "Head3",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,-0.7071067811865476,@@ -930,7 +930,7 @@},{"name": "IntakeRetainer3",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -1018,7 +1018,7 @@},{"name": "ExhaustRetainer3",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -1062,7 +1062,7 @@},{"name": "Rod4",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.7071067811865475,0.7071067811865476,@@ -1106,7 +1106,7 @@},{"name": "PistonSkirt4",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865474,0.7071067811865477,@@ -1128,7 +1128,7 @@},{"name": "PistonLugA4",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865474,0.7071067811865477,@@ -1150,7 +1150,7 @@},{"name": "PistonLugB4",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865474,0.7071067811865477,@@ -1194,7 +1194,7 @@},{"name": "Cylinder4",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,0.7071067811865476,@@ -1216,7 +1216,7 @@},{"name": "Head4",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,0.7071067811865476,@@ -1282,7 +1282,7 @@},{"name": "IntakeRetainer4",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -1370,7 +1370,7 @@},{"name": "ExhaustRetainer4",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -1414,7 +1414,7 @@},{"name": "Rod5",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.45919488658892843,-0.8883355537917984,@@ -1458,7 +1458,7 @@},{"name": "PistonSkirt5",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865476,-0.7071067811865476,@@ -1480,7 +1480,7 @@},{"name": "PistonLugA5",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865476,-0.7071067811865476,@@ -1502,7 +1502,7 @@},{"name": "PistonLugB5",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865476,-0.7071067811865476,@@ -1546,7 +1546,7 @@},{"name": "Cylinder5",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,-0.7071067811865476,@@ -1568,7 +1568,7 @@},{"name": "Head5",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,-0.7071067811865476,@@ -1634,7 +1634,7 @@},{"name": "IntakeRetainer5",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -1722,7 +1722,7 @@},{"name": "ExhaustRetainer5",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -1766,7 +1766,7 @@},{"name": "Rod6",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.7071067811865476,0.7071067811865476,@@ -1810,7 +1810,7 @@},{"name": "PistonSkirt6",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865476,0.7071067811865476,@@ -1832,7 +1832,7 @@},{"name": "PistonLugA6",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865476,0.7071067811865476,@@ -1854,7 +1854,7 @@},{"name": "PistonLugB6",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865476,0.7071067811865476,@@ -1898,7 +1898,7 @@},{"name": "Cylinder6",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,0.7071067811865476,@@ -1920,7 +1920,7 @@},{"name": "Head6",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,0.7071067811865476,@@ -1986,7 +1986,7 @@},{"name": "IntakeRetainer6",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -2074,7 +2074,7 @@},{"name": "ExhaustRetainer6",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -2118,7 +2118,7 @@},{"name": "Rod7",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.7071067811865476,-0.7071067811865476,@@ -2162,7 +2162,7 @@},{"name": "PistonSkirt7",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865476,-0.7071067811865476,@@ -2184,7 +2184,7 @@},{"name": "PistonLugA7",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865476,-0.7071067811865476,@@ -2206,7 +2206,7 @@},{"name": "PistonLugB7",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865476,-0.7071067811865476,@@ -2250,7 +2250,7 @@},{"name": "Cylinder7",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,-0.7071067811865476,@@ -2272,7 +2272,7 @@},{"name": "Head7",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,-0.7071067811865476,@@ -2338,7 +2338,7 @@},{"name": "IntakeRetainer7",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -2426,7 +2426,7 @@},{"name": "ExhaustRetainer7",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,-0.7071067811865476,@@ -2470,7 +2470,7 @@},{"name": "Rod8",- "meshSha256": "F37704DE87AFE6959757C339EB04B98931E1B2F03979CE49E98A94F44184460C",+ "meshSha256": "B52987EF34AD28D80BDAB55CFFCEB166B2F19EE43AE3D1C5AD8A7FEF788701CD","rest": [0.8883355537917985,0.45919488658892843,@@ -2514,7 +2514,7 @@},{"name": "PistonSkirt8",- "meshSha256": "49468B687516AAFC70233E9DAEA4712D49E11EC8B293AC0306EE835E8C026840",+ "meshSha256": "49C905BB5C233A4534B964D1C8CB2EAA64B93B2A855D54AA9B1074C8C31F3569","rest": [0.7071067811865477,0.7071067811865477,@@ -2536,7 +2536,7 @@},{"name": "PistonLugA8",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,0.7071067811865477,@@ -2558,7 +2558,7 @@},{"name": "PistonLugB8",- "meshSha256": "4631B21D2469360822161C579C2DF6E5CE50766D659172AFAEE41C81492E1245",+ "meshSha256": "84E05EAB63B807074DBCD34AB9A4F4C01DB2B401BB37AFBDF90FCB4B2B95E46D","rest": [0.7071067811865477,0.7071067811865477,@@ -2602,7 +2602,7 @@},{"name": "Cylinder8",- "meshSha256": "E3D943A132768C3D49685755A55ECFE72528F59FD062B582517F366F9DC910D0",+ "meshSha256": "BA87301F551F57AE156A685F7DF8A9BE3C2616779CD39DD8928114979010A7E7","rest": [0.7071067811865476,0.7071067811865476,@@ -2624,7 +2624,7 @@},{"name": "Head8",- "meshSha256": "8F8830EF187D5EFCAA4965930E7A7E9AE33827410988A21CF7214876C4057BFF",+ "meshSha256": "442B0F499FA15BD76464D481F22A42F797E65F1B31F721132BD9CF677222D8C1","rest": [0.7071067811865476,0.7071067811865476,@@ -2690,7 +2690,7 @@},{"name": "IntakeRetainer8",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -2778,7 +2778,7 @@},{"name": "ExhaustRetainer8",- "meshSha256": "61F4684873E25B13AE5D7DE8F946C2B5AB8C4D60F117A6EEA515A59B188F7FD5",+ "meshSha256": "D700D5C10B9D2EAC7A23C5D7EA50F1809165148FF7B3AA4D71E3197F0340A5AE","rest": [0.7071067811865476,0.7071067811865476,@@ -3108,7 +3108,7 @@},{"name": "MainSupport1",- "meshSha256": "BBD3BAF517A2BEB6C31CD5ADA6BCEE9E2A6DC322C6A82CADE5805DEEA5242866",+ "meshSha256": "1968F43450CF223966E275599722AC3C7E374C1D526F808C6CB2A827A1911316","rest": [1,0,@@ -3152,7 +3152,7 @@},{"name": "MainSupport2",- "meshSha256": "BBD3BAF517A2BEB6C31CD5ADA6BCEE9E2A6DC322C6A82CADE5805DEEA5242866",+ "meshSha256": "1968F43450CF223966E275599722AC3C7E374C1D526F808C6CB2A827A1911316","rest": [1,0,@@ -3196,7 +3196,7 @@},{"name": "MainSupport3",- "meshSha256": "BBD3BAF517A2BEB6C31CD5ADA6BCEE9E2A6DC322C6A82CADE5805DEEA5242866",+ "meshSha256": "1968F43450CF223966E275599722AC3C7E374C1D526F808C6CB2A827A1911316","rest": [1,0,@@ -3240,7 +3240,7 @@},{"name": "MainSupport4",- "meshSha256": "BBD3BAF517A2BEB6C31CD5ADA6BCEE9E2A6DC322C6A82CADE5805DEEA5242866",+ "meshSha256": "1968F43450CF223966E275599722AC3C7E374C1D526F808C6CB2A827A1911316","rest": [1,0,@@ -3284,7 +3284,7 @@},{"name": "MainSupport5",- "meshSha256": "BBD3BAF517A2BEB6C31CD5ADA6BCEE9E2A6DC322C6A82CADE5805DEEA5242866",+ "meshSha256": "1968F43450CF223966E275599722AC3C7E374C1D526F808C6CB2A827A1911316","rest": [1,0,@@ -3394,7 +3394,7 @@},{"name": "TimingLobe1In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3416,7 +3416,7 @@},{"name": "TimingLobe1Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3438,7 +3438,7 @@},{"name": "TimingLobe3In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3460,7 +3460,7 @@},{"name": "TimingLobe3Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3482,7 +3482,7 @@},{"name": "TimingLobe5In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3504,7 +3504,7 @@},{"name": "TimingLobe5Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3526,7 +3526,7 @@},{"name": "TimingLobe7In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3548,7 +3548,7 @@},{"name": "TimingLobe7Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3592,7 +3592,7 @@},{"name": "TimingLobe2In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3614,7 +3614,7 @@},{"name": "TimingLobe2Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3636,7 +3636,7 @@},{"name": "TimingLobe4In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3658,7 +3658,7 @@},{"name": "TimingLobe4Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3680,7 +3680,7 @@},{"name": "TimingLobe6In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3702,7 +3702,7 @@},{"name": "TimingLobe6Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3724,7 +3724,7 @@},{"name": "TimingLobe8In",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3746,7 +3746,7 @@},{"name": "TimingLobe8Ex",- "meshSha256": "67BC13AF0AEEA43BD7CB465AE34E4880B09FD72A64F847EAE41841F71EC9453B",+ "meshSha256": "FECCBDF2F88DE6927640EF98B88FF01424D5507F82AD1BEFC816921D46CE9545","rest": [1,0,@@ -3768,5 +3768,6 @@}],"originalImplementationCommit": "96aa41ca58f4facd46bb7e8afa93f18524dc068d",- "reproduction": "Run demos/Aetheris.EditableV8 at originalImplementationCommit with default V8Spec; compare baseline.mesh.json and baseline.motion.json through EngineTests.AssertGeometryReference."+ "reproduction": "Run the current demos/Aetheris.EditableV8 with default V8Spec; compare baseline.mesh.json and baseline.motion.json through EngineTests.AssertGeometryReference. Original source and implementation identities describe design provenance; mesh projection was requalified after the analytic edge export correction.",+ "meshReferenceRevision": "analytic-edge-bases-and-stable-quad-ties-2026-10-24"}diff --git a/fixtures/Canonical/EditableV8/geometry-reference.meshes.zip b/fixtures/Canonical/EditableV8/geometry-reference.meshes.zipindex 82029bb5..4d6e6e33 100644Binary files a/fixtures/Canonical/EditableV8/geometry-reference.meshes.zip and b/fixtures/Canonical/EditableV8/geometry-reference.meshes.zip differdiff --git a/scripts/Publish-CadmataDesktop.ps1 b/scripts/Publish-CadmataDesktop.ps1index 8579b89c..240418a9 100644--- a/scripts/Publish-CadmataDesktop.ps1+++ b/scripts/Publish-CadmataDesktop.ps1@@ -21,10 +21,8 @@ New-Item -ItemType Directory -Path $work | Out-Null$publish = Join-Path $work 'publish'dotnet publish (Join-Path $repo 'Aetheris.Cadmata.Desktop/Aetheris.Cadmata.Desktop.csproj') -c Release -r win-x64 --self-contained true -m:1 -nr:false -p:UseSharedCompilation=false -t:Rebuild -p:Version=$Version -p:DebugType=None -p:DebugSymbols=false -o $publish-# Keep the server entry point for explicit headless use; the public apphost is-# the existing WinForms/WebView2 desktop, not the server's similarly named exe.-Move-Item -LiteralPath (Join-Path $publish 'Cadmata.exe') -Destination (Join-Path $publish 'Cadmata.Server.exe')-Move-Item -LiteralPath (Join-Path $publish 'Cadmata.Desktop.exe') -Destination (Join-Path $publish 'Cadmata.exe')+# Cadmata.exe is the browser-first server/launcher. Cadmata.Desktop.exe is an+# optional Windows window using the shared WebView2 runtime. Keep their names.Remove-Item -LiteralPath (Join-Path $publish 'Aetheris.Forge.Host.exe') -ErrorAction SilentlyContinue$desktopDeps = Get-Content -LiteralPath (Join-Path $publish 'Cadmata.Desktop.deps.json') -Raw | ConvertFrom-Json$runtimeTarget = $desktopDeps.targets.PSObject.Properties[$desktopDeps.runtimeTarget.name].Value@@ -49,20 +47,24 @@ foreach ($file in Get-ChildItem -LiteralPath $publish -Recurse -File) {Copy-Item -LiteralPath $file.FullName -Destination $destination}-# Same pinned offline browser as the existing portable desktop distribution.-# WebView2 is the desktop UI runtime; it is not included in the CLI NuGet tool.-$runtimeVersion = '153.0.4234.48'-$runtimeUrl = 'https://msedge.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/08cd33ee-d109-49b8-9301-9f0bea43c575/Microsoft.WebView2.FixedVersionRuntime.153.0.4234.48.x64.cab'-$runtimeHash = '11E8240CB0BC56DCD3E4498907203C251346F65107FE35A3A13E152C7D51C79E'-if (-not $WebViewCab) {- $WebViewCab = Join-Path $work 'webview2-x64.cab'- Invoke-WebRequest $runtimeUrl -OutFile $WebViewCab+# Normal releases reuse the shared Evergreen runtime. Only an explicitly supplied+# pinned CAB requests an offline fixed-runtime package; never download a private+# browser implicitly. Keep the WebView2 SDK assemblies and native loader.+$runtimeMode = 'Evergreen'+$runtimeVersion = $null+$runtimeUrl = $null+$runtimeHash = $null+if ($WebViewCab) {+ $runtimeMode = 'Fixed'+ $runtimeVersion = '153.0.4234.48'+ $runtimeUrl = 'https://msedge.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/08cd33ee-d109-49b8-9301-9f0bea43c575/Microsoft.WebView2.FixedVersionRuntime.153.0.4234.48.x64.cab'+ $runtimeHash = '11E8240CB0BC56DCD3E4498907203C251346F65107FE35A3A13E152C7D51C79E'+ if ((Get-FileHash -LiteralPath $WebViewCab -Algorithm SHA256).Hash -ne $runtimeHash) { throw 'Fixed WebView2 CAB hash mismatch.' }+ $expanded = Join-Path $work 'runtime-expanded'+ New-Item -ItemType Directory -Path $expanded | Out-Null+ expand.exe $WebViewCab '-F:*' $expanded > (Join-Path $work 'runtime-expansion.log')+ Copy-Item -LiteralPath (Join-Path $expanded "Microsoft.WebView2.FixedVersionRuntime.$runtimeVersion.x64") -Destination (Join-Path $bundle 'webview2') -Recurse}-if ((Get-FileHash -LiteralPath $WebViewCab -Algorithm SHA256).Hash -ne $runtimeHash) { throw 'Fixed WebView2 CAB hash mismatch.' }-$expanded = Join-Path $work 'runtime-expanded'-New-Item -ItemType Directory -Path $expanded | Out-Null-expand.exe $WebViewCab '-F:*' $expanded > (Join-Path $work 'runtime-expansion.log')-Copy-Item -LiteralPath (Join-Path $expanded "Microsoft.WebView2.FixedVersionRuntime.$runtimeVersion.x64") -Destination (Join-Path $bundle 'webview2') -RecurseNew-Item -ItemType Directory -Force -Path (Join-Path $bundle 'samples') | Out-NullCopy-Item -LiteralPath (Join-Path $repo 'fixtures/Canonical/Integration/machined-mounting-block.firmament') -Destination (Join-Path $bundle 'samples/mounting-block.firmament')$frontend = Join-Path $repo 'aetheris.client/dist'@@ -70,7 +72,7 @@ if (-not (Test-Path -LiteralPath (Join-Path $frontend 'bundled-packages.json')))New-Item -ItemType Directory -Force -Path (Join-Path $bundle 'wwwroot') | Out-NullGet-ChildItem -LiteralPath $frontend | ForEach-Object { Copy-Item -LiteralPath $_.FullName -Destination (Join-Path $bundle 'wwwroot') -Recurse -Force }$compilerRevision = (Get-Content -LiteralPath (Join-Path $PSScriptRoot 'managed-wgsl-commit-pin.txt') -Raw).Trim()-@{version=$Version;identity="$Version+$sourceRevision" + $(if ($modified) { '.modified' } else { '' });sourceRevision=$sourceRevision;modifiedSource=$modified;webviewVersion=$runtimeVersion;webviewCabUrl=$runtimeUrl;webviewCabSha256=$runtimeHash} | ConvertTo-Json | Set-Content -LiteralPath (Join-Path $bundle 'BUILD-METADATA.json')+@{version=$Version;identity="$Version+$sourceRevision" + $(if ($modified) { '.modified' } else { '' });sourceRevision=$sourceRevision;modifiedSource=$modified;defaultPresentation='Browser';desktopExecutable='Cadmata.Desktop.exe';webviewMode=$runtimeMode;webviewVersion=$runtimeVersion;webviewCabUrl=$runtimeUrl;webviewCabSha256=$runtimeHash} | ConvertTo-Json | Set-Content -LiteralPath (Join-Path $bundle 'BUILD-METADATA.json')@"# Corresponding sourcediff --git a/scripts/Test-CadmataBundle.ps1 b/scripts/Test-CadmataBundle.ps1index 20d4a730..0b216e28 100644--- a/scripts/Test-CadmataBundle.ps1+++ b/scripts/Test-CadmataBundle.ps1@@ -18,7 +18,10 @@ if (Test-Path -LiteralPath $output) { throw 'Use a fresh smoke output directory.New-Item -ItemType Directory -Path $output | Out-Null$stdout = Join-Path $output 'cadmata.stdout.log'$stderr = Join-Path $output 'cadmata.stderr.log'-$hostPath = Join-Path $bundle 'Cadmata.Server.exe'+$hostPath = Join-Path $bundle $(if (Test-Path -LiteralPath (Join-Path $bundle 'Cadmata.Desktop.exe')) { 'Cadmata.exe' } else { 'Cadmata.Server.exe' })+if ($metadata.webviewMode -eq 'Evergreen' -and (Test-Path -LiteralPath (Join-Path $bundle 'webview2'))) {+ throw 'An Evergreen bundle must not carry a private browser runtime.'+}# This test owns the child lifetime. It binds a temporary loopback port and# verifies the extracted production assets and STEP API without a dev server.diff --git a/scripts/freeze-editable-v8-reference.py b/scripts/freeze-editable-v8-reference.pyindex 7cc8e907..9d941f1a 100644--- a/scripts/freeze-editable-v8-reference.py+++ b/scripts/freeze-editable-v8-reference.py@@ -1,4 +1,4 @@-"""Recover the V8 numeric golden only from meshes matching the existing hashes."""+"""Recover the V8 numeric golden only from meshes matching the qualified hashes."""import argparseimport hashlib@@ -25,10 +25,10 @@ def freeze(source: Path, output: Path) -> None:data.extend(struct.pack(f"<{len(indices)}i", *indices))fingerprint = hashlib.sha256(data).hexdigest().upper()if fingerprint not in expected:- raise ValueError(f"Mesh does not match the original baseline: {fingerprint}")+ raise ValueError(f"Mesh does not match the qualified baseline: {fingerprint}")entries[fingerprint] = dataif set(entries) != expected:- raise ValueError("Missing original baseline definitions")+ raise ValueError("Missing qualified baseline definitions")output.parent.mkdir(parents=True, exist_ok=True)with zipfile.ZipFile(output, "w") as archive:for fingerprint, data in sorted(entries.items()):diff --git a/scripts/qualify-cadmata-portable.mts b/scripts/qualify-cadmata-portable.mtsindex 3fcbf0d5..e82faa0c 100644--- a/scripts/qualify-cadmata-portable.mts+++ b/scripts/qualify-cadmata-portable.mts@@ -20,9 +20,10 @@ await new Promise<void>((resolve, reject) => {const debugPort = Number(process.env.CADMATA_QUALIFICATION_DEBUG_PORT ?? (reservation.address() as { port: number }).port);await new Promise<void>(resolve => reservation.close(() => resolve()));const metadata = JSON.parse(await readFile(join(packageDirectory, "BUILD-METADATA.json"), "utf8"));-const executableSha256 = createHash("sha256").update(await readFile(join(packageDirectory, "Cadmata.exe"))).digest("hex");+const desktopExecutable = (await readdir(packageDirectory)).includes("Cadmata.Desktop.exe") ? "Cadmata.Desktop.exe" : "Cadmata.exe";+const executableSha256 = createHash("sha256").update(await readFile(join(packageDirectory, desktopExecutable))).digest("hex");const started = Date.now();-const app = spawn(join(packageDirectory, "Cadmata.exe"), startupFile ? [startupFile] : [], {+const app = spawn(join(packageDirectory, desktopExecutable), startupFile ? [startupFile] : [], {cwd: process.env.CADMATA_QUALIFICATION_CWD ?? process.env.SystemRoot,windowsHide: false, // WinExe has no console; qualify the visible product window.env: {@@ -36,11 +37,15 @@ const app = spawn(join(packageDirectory, "Cadmata.exe"), startupFile ? [startupFassert(app.pid, "The extracted app must start");let closed = false;app.on("exit", () => closed = true);-const report: Record<string, unknown> = { executable: join(packageDirectory, "Cadmata.exe"), pid: app.pid,+const report: Record<string, unknown> = { executable: join(packageDirectory, desktopExecutable), pid: app.pid,qualification: "automated actual packaged WebView2 session; not a human manual session",guards: ["System32-only application PATH", "unrelated CWD", "fresh browser profile", "external web requests blocked by desktop host"], };-report.package = { identity: metadata.identity, webviewVersion: metadata.webviewVersion,+report.package = { identity: metadata.identity, webviewMode: metadata.webviewMode ?? "Fixed", webviewVersion: metadata.webviewVersion,executableSha256, modifiedSource: metadata.modifiedSource };+if (metadata.webviewMode === "Evergreen") {+ assert(!(await readdir(packageDirectory)).includes("webview2"), "Evergreen package must not carry a private browser runtime");+ assert.equal(metadata.webviewVersion, null, "Evergreen package must not claim a pinned browser version");+}const logs = join(process.env.LOCALAPPDATA!, "Aetheris/Cadmata/logs");async function nativeWindows(sendClose: boolean): Promise<number> {const closeCommand = `@@ -135,7 +140,55 @@ try {report.diagnosticLog = join(logs, logFile);report.unauthenticatedStatus = (await fetch(address + "/api/v1/startup/step", { method: "POST" })).status;assert.equal(report.unauthenticatedStatus, 403);- await page.locator('[aria-label="Assembly product tree"] button').first().waitFor({ timeout: 45000 });+ if (startupFile) await page.locator('[aria-label="Assembly product tree"] button').first().waitFor({ timeout: 45000 });+ else {+ await page.getByText("Ready. Select a file to import.", { exact: true }).waitFor();+ assert(await page.getByRole("button", { name: "Refresh Display Data", exact: true }).isDisabled(), "Blank workspace cannot refresh stale geometry");+ assert.equal(await page.locator('[aria-label="Assembly product tree"]').count(), 0);+ report.blankStartup = true;+ await page.screenshot({ path: join(outputDirectory, "packaged-blank-startup.png") });+ await page.getByRole("tab", { name: "Product Gallery", exact: true }).click();+ await page.getByLabel("Export filename").fill("products/mounting-plate.step");+ const generatedResponse = page.waitForResponse(response => response.request().method() === "POST" && response.url().includes("/gallery/templates/"));+ await page.getByRole("button", { name: "Generate / Update Part", exact: true }).click();+ const generated = await (await generatedResponse).json();+ assert(generated.success);+ const artifact = generated.data.artifacts.find((a: { kind: string }) => a.kind === "StepAp242");+ assert(artifact, "Gallery wire artifact kind must match the UI contract");+ assert.equal(artifact.exportPath, "products/mounting-plate.step");+ await page.getByText(/Generated in/).waitFor({ timeout: 120000 });+ await page.waitForFunction(() => {+ const display = JSON.parse(document.querySelector("canvas")?.getAttribute("data-telos-display") ?? "{}");+ return display.meshSurfaces > 0 || display.fields > 0;+ });+ await page.screenshot({ path: join(outputDirectory, "packaged-gallery-preview.png") });+ report.galleryPreview = { artifactKind: artifact.kind, exportPath: artifact.exportPath, sha256: artifact.sha256 };+ await page.getByRole("tab", { name: "STEP 242 Viewer", exact: true }).click();+ const galleryDownloadSession = await context.newCDPSession(page);+ await galleryDownloadSession.send("Browser.setDownloadBehavior", { behavior: "allow", downloadPath: outputDirectory, eventsEnabled: true });+ const galleryDownload = new Promise<string>(resolve => galleryDownloadSession.once("Browser.downloadWillBegin", (event: { suggestedFilename: string }) => resolve(event.suggestedFilename)));+ await page.getByRole("button", { name: "Download Canonical 242", exact: true }).click();+ assert.equal(await Promise.race([galleryDownload, new Promise<never>((_, reject) => setTimeout(() => reject(new Error("Gallery canonical download missing")), 15000))]), "mounting-plate.step");+ await galleryDownloadSession.detach();+ report.productDownloadName = "mounting-plate.step";+ await page.getByRole("button", { name: "New Document", exact: true }).click();+ await page.getByText("Ready. Select a file to import.", { exact: true }).waitFor();+ assert(await page.getByRole("button", { name: "Refresh Display Data", exact: true }).isDisabled());+ await page.getByRole("tab", { name: /Modeling Demo/ }).click();+ const composedResponse = page.waitForResponse(response => response.url().endsWith("/demos/composed-block"));+ await page.getByRole("button", { name: "Build composed part", exact: true }).click();+ const composed = await (await composedResponse).json();+ assert(composed.success);+ assert.equal(composed.data.materializationRoute, "PrismaticSectionStack/Add");+ await writeFile(join(outputDirectory, "composed-block.firmament"), composed.data.source);+ await page.getByText(/Composed block built/).waitFor({ timeout: 120000 });+ await page.getByRole("button", { name: "Refresh Display Data", exact: true }).click();+ await page.getByRole("button", { name: "Refresh Display Data", exact: true }).waitFor({ state: "visible" });+ await page.waitForFunction(() => ![...document.querySelectorAll<HTMLButtonElement>("button")].find(button => button.textContent === "Refresh Display Data")?.disabled);+ await page.screenshot({ path: join(outputDirectory, "packaged-composed-block.png") });+ report.modelingDemo = { route: composed.data.materializationRoute, refreshed: true };+ await page.getByRole("tab", { name: "STEP 242 Viewer", exact: true }).click();+ }await page.waitForFunction(() => document.querySelector('[data-display-host="three-telos"]')?.getAttribute("aria-busy") === "false");report.sampleVisibleMs = Date.now() - started;report.gpu = await page.evaluate(async () => {@@ -166,9 +219,51 @@ try {await page.mouse.up({ button: "right" });await page.mouse.wheel(0, -130);await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2);- await page.locator('[aria-label="Assembly product tree"] .active-row').waitFor();+ if (startupFile) await page.locator('[aria-label="Assembly product tree"] .active-row').waitFor();await page.screenshot({ path: join(outputDirectory, "packaged-orbit-selection.png") });report.navigationAndSelection = true;+ const standardView = page.getByRole("combobox", { name: "Standard view", exact: true });+ await standardView.selectOption("top");+ await page.waitForTimeout(200);+ const topView = await canvas.screenshot();+ await standardView.selectOption("bottom");+ await page.waitForTimeout(200);+ assert(!topView.equals(await canvas.screenshot()), "Top and bottom orientations must produce distinct projected views");+ await standardView.selectOption("iso");+ report.standardViews = ["top", "bottom", "iso"];+ if (process.env.CADMATA_QUALIFICATION_DIAGNOSTIC_STEP) {+ // Optional real noisy import: prove that presentation is concise without+ // discarding diagnostics or changing the importer qualification.+ await page.locator('input[type="file"]').setInputFiles(resolve(process.env.CADMATA_QUALIFICATION_DIAGNOSTIC_STEP));+ const importedResponse = page.waitForResponse(response => response.request().method() === "POST" && response.url().endsWith("/import/step"), { timeout: 120000 });+ await page.getByRole("button", { name: "Import STEP 242", exact: true }).click();+ const imported = await (await importedResponse).json();+ assert(imported.success, "Noisy STEP must be imported, not rejected");+ const diagnostics = imported.data.diagnostics as { severity: string; code: string; source: string | null; message: string }[];+ assert(diagnostics.some(d => ["info", "information", "warning"].includes(d.severity.toLowerCase())), "Fixture must exercise nonfatal diagnostic noise");+ await page.getByText(new RegExp(`^${imported.data.importStatus}: Import complete\\.`)).waitFor({ timeout: 120000 });+ await page.waitForFunction(() => !document.querySelector('[data-display-host="three-telos"][aria-busy="true"]'), undefined, { timeout: 120000 });+ for (const d of diagnostics.filter(d => ["info", "information", "warning"].includes(d.severity.toLowerCase())))+ assert.equal(await page.getByText(`[${d.severity}] ${d.code}: ${d.message}`, { exact: true }).count(), 0, "Nonfatal diagnostic text must not flood the UI");+ await page.screenshot({ path: join(outputDirectory, "packaged-import-diagnostic-summary.png") });+ const logSession = await context.newCDPSession(page);+ await logSession.send("Browser.setDownloadBehavior", { behavior: "allow", downloadPath: outputDirectory, eventsEnabled: true });+ const download = new Promise<string>(resolve => logSession.once("Browser.downloadWillBegin", (event: { suggestedFilename: string }) => resolve(event.suggestedFilename)));+ await page.getByRole("button", { name: "Download diagnostic log", exact: true }).click();+ const logName = await Promise.race([download, new Promise<never>((_, reject) => setTimeout(() => reject(new Error("Diagnostic log download missing")), 15000))]);+ let downloaded = "";+ for (let attempt = 0; ; attempt++) {+ try { downloaded = await readFile(join(outputDirectory, logName), "utf8"); assert(downloaded.length > 0); break; }+ catch (error) { if (attempt > 60) throw error; await new Promise(resolve => setTimeout(resolve, 250)); }+ }+ for (const d of diagnostics) assert(downloaded.includes(d.message), "Downloaded log must retain every original diagnostic message");+ const nativeLog = await readFile(String(report.diagnosticLog), "utf8");+ const events = nativeLog.split("\n").filter(line => line.includes("frontend ")).map(line => JSON.parse(line.slice(line.indexOf("frontend ") + 9)));+ assert(events.some(event => event.event === "CAD diagnostics" && JSON.stringify(event.detail.diagnostics) === JSON.stringify(diagnostics)), "Desktop session log must retain the full structured diagnostic list");+ report.noisyImport = { status: imported.data.importStatus, qualifications: imported.data.importQualifications,+ diagnosticCount: diagnostics.length, downloadedLog: logName, nativeLogPreserved: true, inlineNonfatalMessages: 0 };+ await logSession.detach();+ }await page.locator('input[type="file"]').setInputFiles(stepFile);await page.getByRole("button", { name: "Import STEP 242", exact: true }).click();await page.getByText("Qualified: Import complete.", { exact: true }).waitFor({ timeout: 120000 });diff --git a/testdata/step242/manifests/nist.v0.canonical-linux.json b/testdata/step242/manifests/nist.v0.canonical-linux.jsonindex c37a615b..26bee280 100644--- a/testdata/step242/manifests/nist.v0.canonical-linux.json+++ b/testdata/step242/manifests/nist.v0.canonical-linux.json@@ -1,5 +1,5 @@{- "testdata/step242/nist/CTC/nist_ctc_03_asme1_ap242-e2.stp": "4020b5730a2b71e9d3678f171c46f4b5891ce3beff5c344eff7cd6dbda10e6cd",- "testdata/step242/nist/FTC/nist_ftc_09_asme1_ap242-e1.stp": "21b87111a1f61ba064f488b29c159536452aa461810cdbb3c3e3c9a7fcaef4e9",- "testdata/step242/nist/STC/nist_stc_09_asme1_ap242-e3.stp": "0a97849ebbb96a0c7761516b769faf7425ff99e1080e74a6e9a3ec0eb704e7c5"+ "testdata/step242/nist/CTC/nist_ctc_03_asme1_ap242-e2.stp": "85a88b7063e6d569b7a44e23c00fd18b573918220b8282d08cb976c90a620b5e",+ "testdata/step242/nist/FTC/nist_ftc_09_asme1_ap242-e1.stp": "c7e42e6a6e0aad2c48f646e03f6a5097429b7a4d9ed24468718512b1ff8088a6",+ "testdata/step242/nist/STC/nist_stc_09_asme1_ap242-e3.stp": "b1b0532b01efb53e726adc1ae371ce41e0114698dcb63d9885a62d8758498f38"}diff --git a/testdata/step242/manifests/nist.v0.report.json b/testdata/step242/manifests/nist.v0.report.jsonindex fb7e8447..9b9a3652 100644--- a/testdata/step242/manifests/nist.v0.report.json+++ b/testdata/step242/manifests/nist.v0.report.json@@ -17,7 +17,7 @@"edges": 318,"faces": 117},- "canonicalSha256": "f7c5e83b9bde6c9abc85209dae7228919ab3655e54c582c7d4abb664d75b7755"+ "canonicalSha256": "34112db67f7d0e88e50804788de4284dfa7d5313374845fb75f690b5350bb2e2"},{"fileId": "testdata_step242_nist_CTC_nist_ctc_02_asme1_ap242-e2",@@ -37,7 +37,7 @@"edges": 1410,"faces": 635},- "canonicalSha256": "42cb87942c413bc8032d8f6e13bbbfbfd7c17d20b620dc12872338977cc3cf59"+ "canonicalSha256": "38d99195ba043ec9f98a6b319b35373745434772445f6fcf1d995949974c0df1"},{"fileId": "testdata_step242_nist_CTC_nist_ctc_03_asme1_ap242-e2",@@ -57,7 +57,7 @@"edges": 354,"faces": 120},- "canonicalSha256": "f4e479c33d5d01e311ff7456598e91fb8043237a41e93d6904e7afa2742a697d"+ "canonicalSha256": "85a88b7063e6d569b7a44e23c00fd18b573918220b8282d08cb976c90a620b5e"},{"fileId": "testdata_step242_nist_CTC_nist_ctc_04_asme1_ap242-e1",@@ -77,7 +77,7 @@"edges": 1108,"faces": 483},- "canonicalSha256": "7a3421904737f69b48e2a47c1f0e1c8de10d7bc7b913683b5808f172038d76d3"+ "canonicalSha256": "9d454f422d94c8a4375cc741d596491648e15d8fb1ec4a2385fbc60ac61e4120"},{"fileId": "testdata_step242_nist_CTC_nist_ctc_05_asme1_ap242-e1",@@ -97,7 +97,7 @@"edges": 331,"faces": 156},- "canonicalSha256": "5a6a946fbf13434377e7ca7965052597eab7213351515cefb26797aa93c8b019"+ "canonicalSha256": "24e5a7ea124779f9389c367ff2e3a31cdae9d76ec5a8cef555e9f79f778f5ca7"},{"fileId": "testdata_step242_nist_FTC_nist_ftc_06_asme1_ap242-e2",@@ -117,7 +117,7 @@"edges": 476,"faces": 187},- "canonicalSha256": "1333c9974092f0b87fa373fbfed0b769a1e9e03c237e4010eb26579b22b3d96b"+ "canonicalSha256": "3a0543da81b49635c1499203c87f0f7fdf761cf571c08009a7c782f334b5f9de"},{"fileId": "testdata_step242_nist_FTC_nist_ftc_07_asme1_ap242-e2",@@ -137,7 +137,7 @@"edges": 865,"faces": 304},- "canonicalSha256": "a6f80792aaa5ed374467341670897e9a70d34dc421d82006c6689fa4750a8a8b"+ "canonicalSha256": "e2642cad595fb2ead2e3947f7a36fb7bba9b2deff1228ece9516c9fd73ad32ab"},{"fileId": "testdata_step242_nist_FTC_nist_ftc_08_asme1_ap242-e1-tg",@@ -177,7 +177,7 @@"edges": 616,"faces": 247},- "canonicalSha256": "46164341247a76f9e65ba946f83fa16a930c9e880e07edd42d75e852e4c54889"+ "canonicalSha256": "abf1ac7b799cc9181d1f88b6f9406474e19d2b0ab3e6d03a661edaa39be19790"},{"fileId": "testdata_step242_nist_FTC_nist_ftc_09_asme1_ap242-e1",@@ -197,7 +197,7 @@"edges": 454,"faces": 158},- "canonicalSha256": "8c4ef481e1c337e5e730091ef098ce99b33b6dec9f1e1c9da8e705162a7d761e"+ "canonicalSha256": "3bd3ac91b8f761059fdf0a3a3d06ebadc5bcd6d2cfd37d942893682f16e44a3e"},{"fileId": "testdata_step242_nist_FTC_nist_ftc_10_asme1_ap242-e2",@@ -217,7 +217,7 @@"edges": 799,"faces": 264},- "canonicalSha256": "961fe8d5bceb54ad061d9247217e2974385184fec000fa91a1b73591b3e327b8"+ "canonicalSha256": "0a8a7d4b2139e3c7974472a2db1b328ac5a8a75869dee7e869139d96dfb16d58"},{"fileId": "testdata_step242_nist_FTC_nist_ftc_11_asme1_ap242-e2",@@ -237,7 +237,7 @@"edges": 104,"faces": 42},- "canonicalSha256": "6f23fa5f4186de4e592e3779ef27da2c29f13839e6dae452c5d5b41e6f272c6d"+ "canonicalSha256": "14844407daef24f74d3121afee941a02a310cd5f31605ed03431d2a0b3ab32e1"},{"fileId": "testdata_step242_nist_STC_nist_stc_06_asme1_ap242-e3",@@ -257,7 +257,7 @@"edges": 310,"faces": 144},- "canonicalSha256": "6af39a3e59d78e5b0a80d53b70263243f3ccac8c86c52b5619848e9c544f4b73"+ "canonicalSha256": "3e2f51dd321be739eef6f65636c9e33a2afb681ea1d0c281b7576204eb640c5e"},{"fileId": "testdata_step242_nist_STC_nist_stc_07_asme1_ap242-e3",@@ -277,7 +277,7 @@"edges": 865,"faces": 304},- "canonicalSha256": "7961c738bac65581792fb5336ecaae633fa6366465e466fc0ac2fb177a7ce38c"+ "canonicalSha256": "a3a92441ebe787a047c459a1bc01994c681cbf2b608e6d3c7704dc5be582f7fd"},{"fileId": "testdata_step242_nist_STC_nist_stc_08_asme1_ap242-e3",@@ -297,7 +297,7 @@"edges": 705,"faces": 270},- "canonicalSha256": "35a86a0c796082d9a9b7b8655ffeaeeef73a935a075c19b40fdf7ebee21be372"+ "canonicalSha256": "869b4ce0ab04da3b3cf7cde445440dd42d094ebdee65d50b334cb37020a3f39b"},{"fileId": "testdata_step242_nist_STC_nist_stc_09_asme1_ap242-e3",@@ -317,7 +317,7 @@"edges": 392,"faces": 125},- "canonicalSha256": "1de645b35facd9e0e5abd502df4839e1aa7ef2228d187fc319f895d41d2ccc9d"+ "canonicalSha256": "c029033a35cafc4879826d6d037603a0402f34b9a9db73233887793ef2eb0624"},{"fileId": "testdata_step242_nist_STC_nist_stc_10_asme1_ap242-e2",@@ -337,6 +337,6 @@"edges": 551,"faces": 256},- "canonicalSha256": "bda02784fb839f47fada74a6df536fe66f118f5242e0069cdf2cda50b53680ca"+ "canonicalSha256": "12f19eb86e1c02791a83fe1a75cb89920e5638f96ce09dce9816e1338d04ec8a"}]diff --git a/ts-lock.toml b/ts-lock.tomlindex 7c8b8014..2dc04d69 100644--- a/ts-lock.toml+++ b/ts-lock.toml@@ -6838,7 +6838,7 @@ Workspace = ''Hash = 'sha256:fd0edff32f0a7f6a440dba81c0f5db644b710adcea7e54a35eef6cf976cb8d7e'[[package]]-ID = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac'+ID = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7'Name = '@aetheris/three-telos'Version = '0.1.0'Source = 'path'@@ -6848,7 +6848,7 @@ Rev = ''TreeHash = ''Path = 'Aetheris.Web.Runtime/telos'Workspace = ''-Hash = 'sha256:84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac'+Hash = 'sha256:eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7'[[module_instance]]ID = 'npm:@acemir/[email protected]#peers=b47b56855796ee10dd4f3e88cf5a62ab27bfcf3a7c95d8e6ed07031ec1e1b88e'@@ -13390,8 +13390,8 @@ State = 'present'Optional = true[[module_instance]]-ID = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac#peers=b47b56855796ee10dd4f3e88cf5a62ab27bfcf3a7c95d8e6ed07031ec1e1b88e'-PackageID = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac'+ID = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7#peers=b47b56855796ee10dd4f3e88cf5a62ab27bfcf3a7c95d8e6ed07031ec1e1b88e'+PackageID = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7'PeerContextID = 'peer-context:sha256:b47b56855796ee10dd4f3e88cf5a62ab27bfcf3a7c95d8e6ed07031ec1e1b88e'[[module_instance.dependency]]@@ -13413,7 +13413,7 @@ InstanceID = 'npm:[email protected]#peers=b47b56855796ee10dd4f3e88cf5a62ab27bfcf3a7cFrom = 'aetheris.client:target:browser'Reference = '@aetheris/three-telos'Kind = 'runtime'-InstanceID = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac#peers=b47b56855796ee10dd4f3e88cf5a62ab27bfcf3a7c95d8e6ed07031ec1e1b88e'+InstanceID = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7#peers=b47b56855796ee10dd4f3e88cf5a62ab27bfcf3a7c95d8e6ed07031ec1e1b88e'[[root_module_instance]]From = 'aetheris.client:target:browser'@@ -13698,7 +13698,7 @@ Reference = 'zod'[[edge]]From = 'aetheris.client:target:browser'-To = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac'+To = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7'Kind = 'runtime'Optional = falseReference = '@aetheris/three-telos'@@ -18226,21 +18226,21 @@ Optional = falseReference = 'use-sync-external-store'[[edge]]-From = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac'+From = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7'To = 'npm:@types/[email protected]'Kind = 'runtime'Optional = falseReference = '@types/three'[[edge]]-From = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac'+From = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7'To = 'npm:@webgpu/[email protected]'Kind = 'runtime'Optional = falseReference = '@webgpu/types'[[edge]]-From = 'path:Aetheris.Web.Runtime/telos#84daa5bce1ebb6e068ad2599bc2eaa09a2d914727e2c3dd7c116940d6dc3caac'+From = 'path:Aetheris.Web.Runtime/telos#eea2aa108921bb5353b14ee5e393a8986fac6595b64024c4e1f31215f0a1ceb7'To = 'npm:[email protected]'Kind = 'runtime'Optional = false