Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Add controlled prismatic top-edge chamfer route
Yuechen Lie17b15dc463b
diff --git a/Aetheris.Kernel.Core.Tests/PrismaticTopEdgeChamferPrototypeTests.cs b/Aetheris.Kernel.Core.Tests/PrismaticTopEdgeChamferPrototypeTests.csnew file mode 100644index 00000000..4d80c21f--- /dev/null+++ b/Aetheris.Kernel.Core.Tests/PrismaticTopEdgeChamferPrototypeTests.cs@@ -0,0 +1,98 @@+using Aetheris.Kernel.Core.Brep.Prismatic;++namespace Aetheris.Kernel.Core.Tests;++public sealed class PrismaticTopEdgeChamferPrototypeTests+{+ [Theory]+ [InlineData(10, 8, 6, 1, "[-5,-4,0]..[5,4,6]")]+ [InlineData(10, 8, 6, 2, "[-5,-4,0]..[5,4,6]")]+ public void ValidTopPositiveXChamfer_UsesPrismaticEmitterAndMatchesControlledTopology(double width, double depth, double height, double chamferDistance, string bounds)+ {+ var result = PrismaticTopEdgeChamferPrototype.Emit(new(width, depth, height, chamferDistance, ExportStep: true));++ Assert.True(result.Succeeded);+ Assert.Equal(PrismaticTopEdgeChamferStatus.Succeeded, result.Status);+ Assert.NotNull(result.Body);+ Assert.Equal("prismatic-top-edge-chamfer-ready-for-controlled-route-evaluation", result.Recommendation);+ Assert.Contains("edge-prismatic-v2-prismatic-emitter-invoked", result.Diagnostics);+ Assert.Contains("edge-prismatic-v2-body-created", result.Diagnostics);+ Assert.Equal(12, result.Topology.VertexCount);+ Assert.Equal(20, result.Topology.EdgeCount);+ Assert.Equal(10, result.Topology.FaceCount);+ Assert.Equal(10, result.Topology.PlanarFaceCount);+ Assert.Equal(0, result.Topology.CylindricalFaceCount);+ Assert.Equal(4, result.Topology.LowerPrismSideFaceCount);+ Assert.Equal(4, result.Topology.TransitionFaceCount);+ Assert.Equal(1, result.Topology.ChamferTransitionFaceCount);+ Assert.Equal(10, result.Topology.LoopCount);+ Assert.Equal(40, result.Topology.CoedgeCount);+ Assert.Equal(bounds, result.Topology.Bounds);+ Assert.Contains("edge-prismatic-v2-topology-validated", result.Diagnostics);+ Assert.True(result.Step.Exported);+ Assert.Empty(result.Step.MissingRequiredMarkers);+ Assert.Empty(result.Step.UnexpectedPresentMarkers);+ Assert.Contains("ISO-10303-21", result.Step.PresentMarkers);+ Assert.Contains("MANIFOLD_SOLID_BREP", result.Step.PresentMarkers);+ Assert.Contains("ADVANCED_FACE", result.Step.PresentMarkers);+ Assert.Contains("PLANE", result.Step.PresentMarkers);+ Assert.Contains("CYLINDRICAL_SURFACE", result.Step.AbsentMarkers);+ Assert.Contains("BREP_WITH_VOIDS", result.Step.AbsentMarkers);+ Assert.Contains("edge-prismatic-v2-step-smoke-succeeded", result.Diagnostics);+ Assert.Contains("edge-prismatic-v2-no-air-edge-sweep-used", result.Diagnostics);+ Assert.Contains("edge-prismatic-v2-no-brep-bounded-chamfer-used", result.Diagnostics);+ Assert.Contains("edge-prismatic-v2-no-topology-graft-used", result.Diagnostics);+ Assert.Contains("edge-prismatic-v2-no-3d-boolean-used", result.Diagnostics);+ Assert.Contains("edge-prismatic-v2-no-production-route-replacement", result.Diagnostics);+ }++ [Fact]+ public void CanonicalSectionStack_IsExplicitIdentityCompatibleTopPositiveXInset()+ {+ var sections = PrismaticTopEdgeChamferPrototype.CreateSectionStack(new(10, 8, 6, 1));++ Assert.Equal([0d, 5d, 6d], sections.Select(s => s.Z));+ Assert.Equal([(-5d, -4d), (5d, -4d), (5d, 4d), (-5d, 4d)], sections[0].OuterLoop);+ Assert.Equal(sections[0].OuterLoop, sections[1].OuterLoop);+ Assert.Equal([(-5d, -4d), (4d, -4d), (4d, 4d), (-5d, 4d)], sections[2].OuterLoop);+ Assert.Equal([0, 1, 2, 3], PrismaticCorrespondenceMap.Identity(4).VertexMap);+ }++ [Theory]+ [InlineData(0, 8, 6, 1, "edge-prismatic-v2-invalid-dimensions-rejected")]+ [InlineData(-10, 8, 6, 1, "edge-prismatic-v2-invalid-dimensions-rejected")]+ [InlineData(10, 0, 6, 1, "edge-prismatic-v2-invalid-dimensions-rejected")]+ [InlineData(10, 8, 0, 1, "edge-prismatic-v2-invalid-dimensions-rejected")]+ [InlineData(double.NaN, 8, 6, 1, "edge-prismatic-v2-invalid-dimensions-rejected")]+ [InlineData(10, double.PositiveInfinity, 6, 1, "edge-prismatic-v2-invalid-dimensions-rejected")]+ [InlineData(10, 8, 6, 0, "edge-prismatic-v2-invalid-chamfer-distance-rejected")]+ [InlineData(10, 8, 6, -1, "edge-prismatic-v2-invalid-chamfer-distance-rejected")]+ [InlineData(10, 8, 6, double.NaN, "edge-prismatic-v2-invalid-chamfer-distance-rejected")]+ [InlineData(10, 8, 6, double.PositiveInfinity, "edge-prismatic-v2-invalid-chamfer-distance-rejected")]+ [InlineData(10, 8, 6, 5, "edge-prismatic-v2-invalid-chamfer-distance-rejected")]+ public void InvalidDimensionsAndChamferDistances_RejectBeforePrismaticEmitter(double width, double depth, double height, double chamferDistance, string diagnostic)+ {+ var result = PrismaticTopEdgeChamferPrototype.Emit(new(width, depth, height, chamferDistance, ExportStep: true));++ Assert.False(result.Succeeded);+ Assert.Equal(PrismaticTopEdgeChamferStatus.Rejected, result.Status);+ Assert.Null(result.Body);+ Assert.False(result.Topology.BodyProduced);+ Assert.False(result.Step.Exported);+ Assert.Contains(diagnostic, result.Diagnostics);+ Assert.DoesNotContain("edge-prismatic-v2-prismatic-emitter-invoked", result.Diagnostics);+ Assert.Equal("prismatic-top-edge-chamfer-invalid-rejected", result.Recommendation);+ }++ [Fact]+ public void UnsupportedSelection_RejectsBeforePrismaticEmitter()+ {+ var result = PrismaticTopEdgeChamferPrototype.Emit(new(10, 8, 6, 1, PrismaticTopEdgeChamferSelection.TopNegativeXSide, ExportStep: true));++ Assert.False(result.Succeeded);+ Assert.Equal(PrismaticTopEdgeChamferStatus.Rejected, result.Status);+ Assert.Contains("edge-prismatic-v2-unsupported-selection-rejected", result.Diagnostics);+ Assert.DoesNotContain("edge-prismatic-v2-prismatic-emitter-invoked", result.Diagnostics);+ Assert.Equal("prismatic-top-edge-chamfer-invalid-rejected", result.Recommendation);+ }+}diff --git a/Aetheris.Kernel.Core/Brep/Prismatic/PrismaticTopEdgeChamferPrototype.cs b/Aetheris.Kernel.Core/Brep/Prismatic/PrismaticTopEdgeChamferPrototype.csnew file mode 100644index 00000000..e317a060--- /dev/null+++ b/Aetheris.Kernel.Core/Brep/Prismatic/PrismaticTopEdgeChamferPrototype.cs@@ -0,0 +1,243 @@+using Aetheris.Kernel.Core.Geometry;++namespace Aetheris.Kernel.Core.Brep.Prismatic;++internal enum PrismaticTopEdgeChamferStatus+{+ Succeeded,+ Rejected,+ Deferred,+ Failed,+}++internal enum PrismaticTopEdgeChamferSelection+{+ TopPositiveXSide,+ TopNegativeXSide,+ TopPositiveYSide,+ TopNegativeYSide,+}++internal sealed record PrismaticTopEdgeChamferRequest(+ double Width,+ double Depth,+ double Height,+ double ChamferDistance,+ PrismaticTopEdgeChamferSelection Selection = PrismaticTopEdgeChamferSelection.TopPositiveXSide,+ bool ExportStep = false);++internal sealed record PrismaticTopEdgeChamferTopologySummary(+ bool BodyProduced,+ int VertexCount,+ int EdgeCount,+ int FaceCount,+ int PlanarFaceCount,+ int CylindricalFaceCount,+ int LowerPrismSideFaceCount,+ int TransitionFaceCount,+ int ChamferTransitionFaceCount,+ int LoopCount,+ int CoedgeCount,+ string Bounds);++internal sealed record PrismaticTopEdgeChamferStepSummary(+ bool Exported,+ IReadOnlyList<string> PresentMarkers,+ IReadOnlyList<string> MissingRequiredMarkers,+ IReadOnlyList<string> AbsentMarkers,+ IReadOnlyList<string> UnexpectedPresentMarkers);++internal sealed record PrismaticTopEdgeChamferResult(+ PrismaticTopEdgeChamferStatus Status,+ BrepBody? Body,+ PrismaticTopEdgeChamferTopologySummary Topology,+ PrismaticTopEdgeChamferStepSummary Step,+ IReadOnlyList<string> Diagnostics,+ string Recommendation)+{+ public bool Succeeded => Status == PrismaticTopEdgeChamferStatus.Succeeded && Body is not null;+}++internal static class PrismaticTopEdgeChamferPrototype+{+ private const double Tol = 1e-9;+ private const int ChamferEdgeIndex = 1;++ private static readonly string[] RequiredStepMarkers = ["ISO-10303-21", "MANIFOLD_SOLID_BREP", "ADVANCED_FACE", "PLANE"];+ private static readonly string[] ForbiddenStepMarkers = ["CYLINDRICAL_SURFACE", "BREP_WITH_VOIDS"];++ public static PrismaticTopEdgeChamferResult Emit(PrismaticTopEdgeChamferRequest request)+ {+ var diagnostics = new List<string> { "edge-prismatic-v2-route-started" };++ var validation = Validate(request, diagnostics);+ if (validation.Status != PrismaticTopEdgeChamferStatus.Succeeded)+ {+ return Stop(validation.Status, diagnostics, validation.Recommendation);+ }++ diagnostics.Add("edge-prismatic-v2-request-validated");+ var sections = CreateSectionStack(request);+ diagnostics.Add("edge-prismatic-v2-section-stack-created");+ var correspondence = PrismaticCorrespondenceMap.Identity(4);+ diagnostics.Add("edge-prismatic-v2-correspondence-created");++ diagnostics.Add("edge-prismatic-v2-prismatic-emitter-invoked");+ var emitted = PrismaticSectionTransitionEmitter.Emit(new PrismaticSectionTransitionRequest(+ sections,+ correspondence,+ new PrismaticSectionTransitionOptions(RunStepSmoke: request.ExportStep, TraceLabel: "edge-prismatic-v2-top-positive-x-chamfer")));++ if (!emitted.Succeeded || emitted.Body is null)+ {+ diagnostics.Add($"edge-prismatic-v2-prismatic-emitter-failed:{MapEmitterFailure(emitted)}");+ return Stop(PrismaticTopEdgeChamferStatus.Failed, diagnostics, "prismatic-top-edge-chamfer-needs-emitter-hardening");+ }++ var topology = SummarizeTopology(emitted.Body, request);+ var chamferTransitionFaces = CountChamferTransitionFaces(sections);+ if (chamferTransitionFaces == 1)+ {+ diagnostics.Add("edge-prismatic-v2-chamfer-transition-face-classified");+ }++ diagnostics.Add("edge-prismatic-v2-body-created");+ diagnostics.Add("edge-prismatic-v2-no-trim-used");+ diagnostics.Add("edge-prismatic-v2-no-air-edge-sweep-used");+ diagnostics.Add("edge-prismatic-v2-no-brep-bounded-chamfer-used");+ diagnostics.Add("edge-prismatic-v2-no-topology-graft-used");+ diagnostics.Add("edge-prismatic-v2-no-3d-boolean-used");+ diagnostics.Add("edge-prismatic-v2-no-production-route-replacement");++ var topologySucceeded = topology.BodyProduced+ && topology.VertexCount == 12+ && topology.EdgeCount == 20+ && topology.FaceCount == 10+ && topology.PlanarFaceCount == 10+ && topology.CylindricalFaceCount == 0+ && topology.LowerPrismSideFaceCount == 4+ && topology.TransitionFaceCount == 4+ && topology.ChamferTransitionFaceCount == 1+ && topology.LoopCount == 10+ && topology.CoedgeCount == 40;+ if (topologySucceeded)+ {+ diagnostics.Add("edge-prismatic-v2-topology-validated");+ }++ var step = MapStep(emitted.Step);+ var stepSucceeded = !request.ExportStep || (step.Exported && step.MissingRequiredMarkers.Count == 0 && step.UnexpectedPresentMarkers.Count == 0);+ if (request.ExportStep)+ {+ diagnostics.Add(stepSucceeded ? "edge-prismatic-v2-step-smoke-succeeded" : "edge-prismatic-v2-step-smoke-failed:markers");+ }++ var succeeded = topologySucceeded && stepSucceeded;+ return new(+ succeeded ? PrismaticTopEdgeChamferStatus.Succeeded : PrismaticTopEdgeChamferStatus.Failed,+ emitted.Body,+ topology,+ step,+ StableDiagnostics(diagnostics),+ succeeded+ ? "prismatic-top-edge-chamfer-ready-for-controlled-route-evaluation"+ : "prismatic-top-edge-chamfer-needs-emitter-hardening");+ }++ internal static IReadOnlyList<PrismaticSection> CreateSectionStack(PrismaticTopEdgeChamferRequest request)+ {+ var x0 = -request.Width * 0.5d;+ var x1 = request.Width * 0.5d;+ var y0 = -request.Depth * 0.5d;+ var y1 = request.Depth * 0.5d;+ var z0 = 0d;+ var z1 = request.Height - request.ChamferDistance;+ var z2 = request.Height;+ var topX = x1 - request.ChamferDistance;++ return+ [+ new PrismaticSection(z0, [(x0, y0), (x1, y0), (x1, y1), (x0, y1)]),+ new PrismaticSection(z1, [(x0, y0), (x1, y0), (x1, y1), (x0, y1)]),+ new PrismaticSection(z2, [(x0, y0), (topX, y0), (topX, y1), (x0, y1)]),+ ];+ }++ private static (PrismaticTopEdgeChamferStatus Status, string Recommendation) Validate(PrismaticTopEdgeChamferRequest request, List<string> diagnostics)+ {+ if (!FinitePositive(request.Width) || !FinitePositive(request.Depth) || !FinitePositive(request.Height))+ {+ diagnostics.Add("edge-prismatic-v2-invalid-dimensions-rejected");+ return (PrismaticTopEdgeChamferStatus.Rejected, "prismatic-top-edge-chamfer-invalid-rejected");+ }++ if (!FinitePositive(request.ChamferDistance))+ {+ diagnostics.Add("edge-prismatic-v2-invalid-chamfer-distance-rejected");+ return (PrismaticTopEdgeChamferStatus.Rejected, "prismatic-top-edge-chamfer-invalid-rejected");+ }++ if (request.Selection != PrismaticTopEdgeChamferSelection.TopPositiveXSide)+ {+ diagnostics.Add("edge-prismatic-v2-unsupported-selection-rejected");+ return (PrismaticTopEdgeChamferStatus.Rejected, "prismatic-top-edge-chamfer-invalid-rejected");+ }++ var halfWidth = request.Width * 0.5d;+ if (request.ChamferDistance >= halfWidth - Tol || request.ChamferDistance >= request.Height - Tol)+ {+ diagnostics.Add("edge-prismatic-v2-invalid-chamfer-distance-rejected");+ return (PrismaticTopEdgeChamferStatus.Rejected, "prismatic-top-edge-chamfer-invalid-rejected");+ }++ return (PrismaticTopEdgeChamferStatus.Succeeded, string.Empty);+ }++ private static PrismaticTopEdgeChamferTopologySummary SummarizeTopology(BrepBody body, PrismaticTopEdgeChamferRequest request) => new(+ true,+ body.Topology.Vertices.Count(),+ body.Topology.Edges.Count(),+ body.Topology.Faces.Count(),+ body.Topology.Faces.Count(f => body.GetFaceSurface(f.Id).Kind == SurfaceGeometryKind.Plane),+ body.Topology.Faces.Count(f => body.GetFaceSurface(f.Id).Kind == SurfaceGeometryKind.Cylinder),+ 4,+ 4,+ CountChamferTransitionFaces(CreateSectionStack(request)),+ body.Topology.Loops.Count(),+ body.Topology.Coedges.Count(),+ FormattableString.Invariant($"[{(-request.Width * 0.5d):0.###},{(-request.Depth * 0.5d):0.###},0]..[{(request.Width * 0.5d):0.###},{(request.Depth * 0.5d):0.###},{request.Height:0.###}]"));++ private static int CountChamferTransitionFaces(IReadOnlyList<PrismaticSection> sections)+ {+ var lower = sections[^2].OuterLoop;+ var upper = sections[^1].OuterLoop;+ var next = (ChamferEdgeIndex + 1) % lower.Count;+ return SamePoint(lower[ChamferEdgeIndex], upper[ChamferEdgeIndex]) && SamePoint(lower[next], upper[next]) ? 0 : 1;+ }++ private static PrismaticTopEdgeChamferStepSummary MapStep(PrismaticSectionTransitionStepSummary step) => new(+ step.Exported,+ step.PresentMarkers,+ step.MissingRequiredMarkers,+ step.AbsentMarkers,+ step.UnexpectedPresentMarkers);++ private static string MapEmitterFailure(PrismaticSectionTransitionResult result)+ {+ var reason = result.Diagnostics.FirstOrDefault(d => d.Contains("request-rejected:", StringComparison.Ordinal) || d.Contains("request-deferred:", StringComparison.Ordinal));+ return string.IsNullOrWhiteSpace(reason) ? result.Status.ToString().ToLowerInvariant() : reason;+ }++ private static PrismaticTopEdgeChamferResult Stop(PrismaticTopEdgeChamferStatus status, List<string> diagnostics, string recommendation) =>+ new(status, null, EmptyTopology(), EmptyStep(), StableDiagnostics(diagnostics), recommendation);++ private static PrismaticTopEdgeChamferTopologySummary EmptyTopology() => new(false, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, "none");++ private static PrismaticTopEdgeChamferStepSummary EmptyStep() => new(false, [], RequiredStepMarkers, ForbiddenStepMarkers, []);++ private static IReadOnlyList<string> StableDiagnostics(IEnumerable<string> diagnostics) => diagnostics.Distinct(StringComparer.Ordinal).OrderBy(x => x, StringComparer.Ordinal).ToArray();++ private static bool FinitePositive(double value) => double.IsFinite(value) && value > Tol;++ private static bool SamePoint((double X, double Y) a, (double X, double Y) b) => System.Math.Sqrt(((a.X - b.X) * (a.X - b.X)) + ((a.Y - b.Y) * (a.Y - b.Y))) <= Tol;+}diff --git a/docs/edge-a1-chamfer-fillet-support-compatibility-matrix.md b/docs/edge-a1-chamfer-fillet-support-compatibility-matrix.mdindex 91b6aa5f..fe8fa77e 100644--- a/docs/edge-a1-chamfer-fillet-support-compatibility-matrix.md+++ b/docs/edge-a1-chamfer-fillet-support-compatibility-matrix.md@@ -8,7 +8,7 @@ The current AirChamfer golden path is strong but narrow: controlled convex planaLegacy bounded chamfer/fillet behavior remains authoritative wherever production behavior exists. In particular, `BrepBoundedChamfer` and `BrepBoundedFillet` are still the production routes for the currently supported bounded cases, and AirEdgeSweep/AirChamfer evidence must not be read as route replacement.-EDGE-A2 reclassifies some chamfer cases as profile/profile-stack candidates rather than AirEdgeSweep candidates: vertical edges of history-known extrusions should be tested as profile modifications, and top/bottom extrusion edges should be tested as profile-stack or section-transition constructions. EDGE-PROFILE-X1 now provides lab evidence for the vertical-edge/profile-authored subset, EDGE-PROFILE-V1 packages that proof into an internal production-adjacent emitter, and EDGE-PROFILE-X2 provides lab-only section-transition evidence for one top horizontal +X side chamfer while documenting current profile-stack generalization blockers. EDGE-PRISMATIC-A0 classifies those top/bottom/horizontal history-known chamfers under the **prismatic section-transition** roadmap, EDGE-PRISMATIC-X1 introduces the first reusable lab-only prismatic emitter, EDGE-PRISMATIC-X2 re-expresses the top +X witness through that emitter, EDGE-PRISMATIC-X3 proves equal-count line-only generic polygon cases, and EDGE-PRISMATIC-V1 packages that capability behind an internal production-adjacent seam. Production statuses remain unchanged until a separately gated route is admitted.+EDGE-A2 reclassifies some chamfer cases as profile/profile-stack candidates rather than AirEdgeSweep candidates: vertical edges of history-known extrusions should be tested as profile modifications, and top/bottom extrusion edges should be tested as profile-stack or section-transition constructions. EDGE-PROFILE-X1 now provides lab evidence for the vertical-edge/profile-authored subset, EDGE-PROFILE-V1 packages that proof into an internal production-adjacent emitter, and EDGE-PROFILE-X2 provides lab-only section-transition evidence for one top horizontal +X side chamfer while documenting current profile-stack generalization blockers. EDGE-PRISMATIC-A0 classifies those top/bottom/horizontal history-known chamfers under the **prismatic section-transition** roadmap, EDGE-PRISMATIC-X1 introduces the first reusable lab-only prismatic emitter, EDGE-PRISMATIC-X2 re-expresses the top +X witness through that emitter, EDGE-PRISMATIC-X3 proves equal-count line-only generic polygon cases, EDGE-PRISMATIC-V1 packages that capability behind an internal production-adjacent seam, and EDGE-PRISMATIC-V2 adds an internal controlled top `+X` horizontal chamfer route that consumes that seam for the rectangular-prism case. Production statuses remain unchanged until a separately gated production route is admitted.The matrix separates five concerns that were previously easy to conflate:@@ -142,7 +142,7 @@ This path is not production-authoritative. It does not support chains, corners,|---|---|---|---|---|---|---|---|---|---|---|---|---|| CH-01 | concave/additive | plane-plane, orthogonal | single edge | constant chamfer distance | no corner | plane | `production-legacy-supported` where bounded internal concave route applies | `lab-supported`; `policy-supported` | EDGE-X1 inventory; EDGE-X2 concave planar patch proof; EDGE-X2.1 policy scaffold | production Air route, shadow parity, corpus | Legacy production only; Air is lab/policy evidence | Preserve legacy; use as concave AirChamfer baseline || CH-02 | concave/additive | plane-plane, non-orthogonal | single edge | constant chamfer distance | no corner | plane | `unknown/no-test` to `production-legacy-supported` only where existing bounded trusted contexts admit it | `lab-supported`; `policy-supported` | EDGE-X2.2 non-orthogonal concave planar policy+patch | production body mutation, feature-recognition parity, corpus | Not production Air-ready | Add parity/shadow fixture after convex route stabilizes |-| CH-03 | convex/replacement | plane-plane, orthogonal controlled body | single edge | constant chamfer distance | no corner | plane | `production-legacy-supported` for legacy bounded box/simple contexts | `production-adjacent-air-prototype`; `shadow-supported`; `artifact-corpus-supported`; `closed-witness-supported`; `gated-opt-in-route-supported`; `profile-authored-lab-supported`; `profile-authored-production-adjacent-emitter-supported` for history-known vertical extrusion edges; `profile-stack-section-transition-lab-supported` and `prismatic-emitter-lab-supported` for one history-known top +X horizontal edge fixture | EDGE-X3 through EDGE-X13, EDGE-V1/V2/V3/V4, EDGE-PROFILE-X1, EDGE-PROFILE-V1, EDGE-PROFILE-X2, EDGE-PRISMATIC-A0, EDGE-PRISMATIC-X1, EDGE-PRISMATIC-X2, CLI tests, FrictionLab AirChamfer tests, ProfileChamfer tests, ProfileStackChamfer tests, ProfileVertexChamfer tests, Firmament shadow-diagnostics and opt-in route tests | default production authority, arbitrary body mutation beyond controlled fixture, production-adjacent profile chamfer admission, production-adjacent prismatic section-transition packaging, validation hardening, and recognition parity | Best current AirChamfer row for no-history/local-edge fixtures; EDGE-PROFILE-X1 proves history-known vertical-edge chamfer can be emitted as profile extrusion; EDGE-PROFILE-V1 packages that path as an internal production-adjacent emitter, still not production-authoritative; EDGE-PROFILE-X2 proves one top horizontal +X side chamfer can be emitted as a lab-only all-planar section-transition witness and records current profile-stack polygon/ruled-transition blockers; EDGE-PRISMATIC-A0 classifies top/bottom/horizontal history-known chamfers under the prismatic section-transition roadmap; EDGE-PRISMATIC-X1 supplies the reusable lab emitter; EDGE-PRISMATIC-X2 confirms the top-edge witness through that emitter | Run EDGE-PRISMATIC-V1 packaging or EDGE-PRISMATIC-X3 generic polygon-transition lab before any production-adjacent prismatic top-edge chamfer route admission |+| CH-03 | convex/replacement | plane-plane, orthogonal controlled body | single edge | constant chamfer distance | no corner | plane | `production-legacy-supported` for legacy bounded box/simple contexts | `production-adjacent-air-prototype`; `shadow-supported`; `artifact-corpus-supported`; `closed-witness-supported`; `gated-opt-in-route-supported`; `profile-authored-lab-supported`; `profile-authored-production-adjacent-emitter-supported` for history-known vertical extrusion edges; `profile-stack-section-transition-lab-supported`, `prismatic-emitter-lab-supported`, and `prismatic-controlled-route-supported` for one history-known top +X horizontal edge fixture | EDGE-X3 through EDGE-X13, EDGE-V1/V2/V3/V4, EDGE-PROFILE-X1, EDGE-PROFILE-V1, EDGE-PROFILE-X2, EDGE-PRISMATIC-A0, EDGE-PRISMATIC-X1, EDGE-PRISMATIC-X2, EDGE-PRISMATIC-X3, EDGE-PRISMATIC-V1, EDGE-PRISMATIC-V2, CLI tests, FrictionLab AirChamfer tests, ProfileChamfer tests, ProfileStackChamfer tests, ProfileVertexChamfer tests, Firmament shadow-diagnostics and opt-in route tests | default production authority, arbitrary body mutation beyond controlled fixture, production-adjacent profile chamfer admission, production-authoritative route admission, validation hardening, and recognition parity | Best current AirChamfer row for no-history/local-edge fixtures; EDGE-PROFILE-X1 proves history-known vertical-edge chamfer can be emitted as profile extrusion; EDGE-PROFILE-V1 packages that path as an internal production-adjacent emitter, still not production-authoritative; EDGE-PROFILE-X2 proves one top horizontal +X side chamfer can be emitted as a lab-only all-planar section-transition witness and records current profile-stack polygon/ruled-transition blockers; EDGE-PRISMATIC-A0 classifies top/bottom/horizontal history-known chamfers under the prismatic section-transition roadmap; EDGE-PRISMATIC-X1 supplies the reusable lab emitter; EDGE-PRISMATIC-X2 confirms the top-edge witness through that emitter; EDGE-PRISMATIC-V1 packages the internal emitter seam; EDGE-PRISMATIC-V2 consumes it in a controlled internal top-edge chamfer route with matching topology and STEP smoke | Run EDGE-PRISMATIC-X4 split/merge policy audit or add a profile/prismatic artifact corpus before any production-authoritative prismatic top-edge chamfer route admission || CH-04 | convex/replacement | plane-plane, non-orthogonal controlled body | single edge | constant chamfer distance | no corner | plane | `production-legacy-supported` only for admitted trusted/triangle-like bounded contexts; otherwise `unknown/no-test` | `shadow-supported`; `artifact-corpus-supported`; `production-adjacent-air-prototype` for safe controlled case | EDGE-X11 non-orthogonal corpus row; EDGE-X12 stability; EDGE-V3 shadow route | broader topology mutation, richer feature-recognition parity, production fallback | Non-authoritative controlled evidence only | Harden controlled non-orthogonal shadow diagnostics || CH-05 | convex/replacement | plane-plane | single edge on arbitrary production body | constant chamfer distance | no corner or endpoint transition as needed | plane | `production-legacy-supported` only for legacy recognized bounded cases | `deferred`; `blocked-by-body-mutation`; partial `production-adjacent-air-prototype` for controlled body | EDGE-V2/V3 controlled prototype and shadow docs | arbitrary edge selection, grafting, identity, regression corpus | Not production Air-ready | EDGE-X15 convex AirChamfer controlled body mutation hardening || CH-06 | convex/replacement | plane-plane | edge chain | constant chamfer distance | chain termination; endpoint transitions | plane sequence plus transition patches | legacy support is bounded/contextual; generic status `unknown/no-test` | `deferred`; `blocked-by-corner-policy`; `blocked-by-body-mutation` | EDGE-V3 deferred edge-chain diagnostics; EDGE-X1 notes | chain policy, termination policy, topology plan, feature-recognition parity | Not ready | EDGE-X16 AirChamfer edge-chain policy lab |@@ -243,10 +243,11 @@ Recommended post-EDGE-X13 roadmap:5. **EDGE-PRISMATIC-A0**: completed as the prismatic section-transition contract audit for top/bottom/horizontal history-known chamfer roadmap classification.6. **EDGE-PRISMATIC-X1**: completed as a lab-only first-scope `PrismaticSectionTransitionEmitter` proof for two/three Z-stacked line-only outer sections with explicit identity correspondence, closed planar BRep emission, split transition intervals, STEP smoke, and deterministic invalid/deferred diagnostics. This upgrades the evidence base for prismatic section transitions but does not change production chamfer/fillet behavior, current `ProfileStackExtrudeExecutor` behavior, AirEdgeSweep, `BrepBoundedChamfer`, STEP exporter/importer code, Boolean core code, triangle migration, sketch solving, clipping, or NURBS/freeform support.7. **EDGE-PRISMATIC-X2**: completed as a lab-only top `+X` horizontal edge chamfer proof through the X1 prismatic emitter, preserving the EDGE-PROFILE-X2 topology and STEP witness while replacing the one-off Route B proof path.-8. **EDGE-CORNER-X1**: manifest-driven single-corner chamfer reconstruction lab.-9. **EDGE-FILLET-A0**: AirFillet architecture audit focused on bounded constant-radius analytic scope.-10. **EDGE-X14**: plane-plane constant-radius AirFillet cylindrical closed witness lab.-11. **EDGE-X15+ / EDGE-V paths**: continue controlled no-history/local-edge AirChamfer hardening only where shadow diagnostics and production-readiness gates remain stable.+8. **EDGE-PRISMATIC-X3/V1/V2**: completed as generic line-only emitter evidence, internal emitter packaging, and a controlled top `+X` horizontal chamfer route through the packaged emitter.+9. **EDGE-CORNER-X1**: manifest-driven single-corner chamfer reconstruction lab.+10. **EDGE-FILLET-A0**: AirFillet architecture audit focused on bounded constant-radius analytic scope.+11. **EDGE-X14**: plane-plane constant-radius AirFillet cylindrical closed witness lab.+12. **EDGE-X15+ / EDGE-V paths**: continue controlled no-history/local-edge AirChamfer hardening only where shadow diagnostics and production-readiness gates remain stable.The roadmap should be adjusted by evidence. If a row reveals recognizer divergence, legacy topology mismatch, or body-mutation instability, the next milestone should narrow to that blocker rather than broadening support claims.@@ -278,3 +279,8 @@ This milestone does not include:## EDGE-PRISMATIC-V1 status noteThe prismatic section-transition row is now **internal production-adjacent / not routed** for Z-axis two/three-section, line-only, one-outer-loop, no-hole, equal-count identity-correspondence transitions. Rectangle, pentagon, hexagon, asymmetric pentagon, and stable+transition rectangle cases validate the topology formula and STEP smoke through the existing exporter. No production chamfer/fillet behavior, ProfileStack behavior, STEP exporter/importer behavior, Boolean core behavior, AirEdgeSweep behavior, public API, triangle migration, sketch solver, clipping engine, or NURBS/freeform support changed.+++## EDGE-PRISMATIC-V2 status note++The top/horizontal history-known chamfer row now has an **internal controlled route / not production-authoritative** witness for the rectangular-prism top `+X` side case. `PrismaticTopEdgeChamferPrototype` accepts controlled dimensions and chamfer distance, validates the supported selection, builds the canonical three-section stack, invokes `PrismaticSectionTransitionEmitter`, produces a closed all-planar BRep with the expected 12 vertices, 20 edges, 10 faces, 10 loops, and 40 coedges, and passes STEP smoke through the existing exporter. No production chamfer/fillet behavior, production route replacement, current `ProfileStackExtrudeExecutor` behavior, STEP exporter/importer behavior, Boolean core behavior, AirEdgeSweep behavior, public API, triangle migration, sketch solver, clipping engine, or NURBS/freeform support changed.diff --git a/docs/edge-a2-constructive-chamfer-reframing-audit.md b/docs/edge-a2-constructive-chamfer-reframing-audit.mdindex 523e8892..4e17bb51 100644--- a/docs/edge-a2-constructive-chamfer-reframing-audit.md+++ b/docs/edge-a2-constructive-chamfer-reframing-audit.md@@ -403,3 +403,8 @@ EDGE-A2 does not do any of the following:- no sketch solver, clipping engine, NURBS, or freeform support;- no modification to current AirChamfer behavior except documentation notes;- no deprecating legacy chamfer route yet.+++## EDGE-PRISMATIC-V2 follow-up status++EDGE-PRISMATIC-V2 implements the controlled top `+X` horizontal rectangular-prism chamfer as a production-adjacent prismatic section-transition route named `PrismaticTopEdgeChamferPrototype`. This validates the A2 reframing for the known top-edge case: construction history emits a section stack and closed planar BRep through `PrismaticSectionTransitionEmitter` rather than trimming, grafting, AirEdgeSweep, `BrepBoundedChamfer`, or 3D Boolean fallback. The route remains internal and non-authoritative; no production chamfer/fillet behavior, `ProfileStackExtrudeExecutor` behavior, STEP exporter/importer behavior, Boolean core behavior, AirEdgeSweep behavior, triangle migration, sketch solver, clipping engine, or NURBS/freeform support changed.diff --git a/docs/edge-prismatic-v2-controlled-top-edge-chamfer-route.md b/docs/edge-prismatic-v2-controlled-top-edge-chamfer-route.mdnew file mode 100644index 00000000..762c1fc6--- /dev/null+++ b/docs/edge-prismatic-v2-controlled-top-edge-chamfer-route.md@@ -0,0 +1,173 @@+# EDGE-PRISMATIC-V2 — Controlled top-edge chamfer route through prismatic section transition++## 1. Purpose and scope++EDGE-PRISMATIC-V2 adds a controlled, internal, production-adjacent route named `PrismaticTopEdgeChamferPrototype` for the history-known rectangular-prism top `+X` horizontal side chamfer. The route proves that the known top-edge chamfer case can be expressed as a Z-axis prismatic section stack and emitted through `PrismaticSectionTransitionEmitter`.++This is not a default production route replacement. It is a bounded candidate path for evaluation and regression evidence only.++## 2. References++- EDGE-PRISMATIC-A0: `docs/edge-prismatic-a0-section-transition-contract-audit.md`.+- EDGE-PRISMATIC-X1: `docs/frictionlab/edge-prismatic-x1-section-transition-emitter-lab.md`.+- EDGE-PRISMATIC-X2: `docs/frictionlab/edge-prismatic-x2-top-edge-chamfer-through-prismatic-emitter-lab.md`.+- EDGE-PRISMATIC-X3: `docs/frictionlab/edge-prismatic-x3-generic-line-profile-transition-lab.md`.+- EDGE-PRISMATIC-V1: `docs/edge-prismatic-v1-section-transition-emitter.md`.+- V2 sweep-first architecture: `docs/aetheris-v2-sweep-first-architecture.md`.+- Resolved Profile2D contract: `docs/aetheris-v2-a1-resolved-profile2d-contract.md`.+- Constructive chamfer reframing audit: `docs/edge-a2-constructive-chamfer-reframing-audit.md`.++## 3. Component and internal API shape++The route lives in `Aetheris.Kernel.Core.Brep.Prismatic` and is internal:++- `PrismaticTopEdgeChamferPrototype.Emit(PrismaticTopEdgeChamferRequest request)`.+- `PrismaticTopEdgeChamferRequest` accepts width, depth, height, chamfer distance, selected side, and optional STEP smoke export.+- `PrismaticTopEdgeChamferResult` returns status, optional `BrepBody`, topology summary, STEP smoke summary, deterministic diagnostics, and recommendation.+- `PrismaticTopEdgeChamferSelection.TopPositiveXSide` is the only admitted selection.++The route packages the existing V1 `PrismaticSectionTransitionEmitter` seam. It does not duplicate the prismatic emitter implementation.++## 4. Supported controlled case++The only supported case is:++- rectangular prism / box-like history-known body;+- top horizontal `+X` side chamfer;+- Z-axis section stack;+- full rectangle lower/stable sections;+- inset `+X` side top section;+- explicit identity correspondence by index;+- line-only profiles;+- no holes, arcs, chains, corners, fillets, or arbitrary edge selection;+- planar faces only;+- closed BRep candidate body;+- optional STEP smoke through the existing `Step242Exporter`.++Admissibility rejects non-finite or non-positive dimensions, non-finite or non-positive chamfer distance, chamfer distances greater than the conservative `min(width / 2, height)` bound, and any selection other than top `+X` side.++## 5. Section stack and correspondence map++For the canonical case:++- width = `10`;+- depth = `8`;+- height = `6`;+- chamfer distance = `1`;+- `z0 = 0`;+- `z1 = 5`;+- `z2 = 6`.++Section `z0` is the full rectangle:++1. `(-5, -4)`;+2. `( 5, -4)`;+3. `( 5, 4)`;+4. `(-5, 4)`.++Section `z1` repeats the full rectangle. Section `z2` is the top `+X` inset rectangle:++1. `(-5, -4)`;+2. `( 4, -4)`;+3. `( 4, 4)`;+4. `(-5, 4)`.++Correspondence is `PrismaticCorrespondenceMap.Identity(4)`. Edge index `1` is the top `+X` side and is classified as the single chamfer transition face in the upper interval.++## 6. Candidate topology contract++For the canonical controlled case, the expected and tested topology is:++| Metric | Expected |+| --- | ---: |+| vertices | 12 |+| edges | 20 |+| faces | 10 |+| planar faces | 10 |+| cylindrical faces | 0 |+| lower prism side faces | 4 |+| transition faces | 4 |+| chamfer transition faces | 1 |+| loops | 10 |+| coedges | 40 |+| bounds | `[-5,-4,0]..[5,4,6]` |++The route preserves the `z = 5` split between stable lower side faces and upper transition faces. It does not merge coplanar faces in this milestone.++## 7. STEP smoke findings++When requested, the route asks the prismatic emitter to run STEP smoke through the existing exporter. The required present markers are:++- `ISO-10303-21`;+- `MANIFOLD_SOLID_BREP`;+- `ADVANCED_FACE`;+- `PLANE`.++The required absent markers are:++- `CYLINDRICAL_SURFACE`;+- `BREP_WITH_VOIDS`.++The canonical case and the larger valid `chamferDistance = 2` case both pass this smoke check in `PrismaticTopEdgeChamferPrototypeTests`.++## 8. Invalid and rejected cases++Focused tests cover rejection before emitter invocation for:++- width, depth, or height less than or equal to zero;+- non-finite dimensions;+- chamfer distance less than or equal to zero;+- non-finite chamfer distance;+- chamfer distance at or beyond the conservative bound;+- unsupported selected side.++Rejected requests return no body, no STEP export, `prismatic-top-edge-chamfer-invalid-rejected`, and deterministic diagnostics such as `edge-prismatic-v2-invalid-dimensions-rejected`, `edge-prismatic-v2-invalid-chamfer-distance-rejected`, or `edge-prismatic-v2-unsupported-selection-rejected`.++## 9. No-trim/no-graft/no-AirEdgeSweep/no-BrepBoundedChamfer/no-3D-Boolean guarantee++The candidate path constructs the section stack and invokes `PrismaticSectionTransitionEmitter`. It does not call AirEdgeSweep, BrepBoundedChamfer, topology graft/body mutation, trim/clipping, sketch solving, or 3D Boolean fallback. Successful diagnostics include:++- `edge-prismatic-v2-prismatic-emitter-invoked`;+- `edge-prismatic-v2-no-trim-used`;+- `edge-prismatic-v2-no-air-edge-sweep-used`;+- `edge-prismatic-v2-no-brep-bounded-chamfer-used`;+- `edge-prismatic-v2-no-topology-graft-used`;+- `edge-prismatic-v2-no-3d-boolean-used`;+- `edge-prismatic-v2-no-production-route-replacement`.++## 10. Relationship to `ProfileStackExtrudeExecutor`++`ProfileStackExtrudeExecutor` is unchanged and is not replaced. V2 consumes the already packaged prismatic emitter seam directly for this controlled history-known top-edge candidate.++## 11. Relationship to chamfer architecture++This route is a history-known top-edge chamfer via prismatic transition. It complements the profile-authored vertical-edge lane and the prismatic section-transition lane. AirEdgeSweep remains the no-history/local-edge architecture path and is not used by this candidate.++## 12. Non-goals++EDGE-PRISMATIC-V2 does not add:++- default production routing;+- public API changes;+- arbitrary production body mutation;+- arbitrary body or edge selection;+- chains, corners, multiple chamfers, or fillets;+- holes, arcs, inferred correspondence, NURBS, or freeform support;+- STEP exporter/importer changes;+- Boolean core changes;+- AirEdgeSweep behavior changes;+- triangle migration retry;+- sketch solver or clipping engine support.++## 13. Tests run++- `dotnet test Aetheris.Kernel.Core.Tests/Aetheris.Kernel.Core.Tests.csproj -f net10.0 --filter "PrismaticTopEdgeChamferPrototype"`.+- Required regression filters for FrictionLab, Kernel.Core, Kernel.Firmament, and CLI were run for this milestone.++## 14. Recommended next milestone++Because EDGE-PRISMATIC-V1 packaging already exists and V2 successfully consumes it, the next milestone should be one of:++1. EDGE-PRISMATIC-X4 coplanar split/merge policy audit, especially around when stable and transition interval faces may or may not merge;+2. EDGE-PROFILE/PRISMATIC artifact corpus for stable STEP/topology regression evidence if this controlled route remains stable;+3. a narrowly scoped route-hardening milestone that keeps production authority unchanged while adding feature-recognition/parity evidence for this exact history-known top-edge case.diff --git a/docs/frictionlab/edge-prismatic-x2-top-edge-chamfer-through-prismatic-emitter-lab.md b/docs/frictionlab/edge-prismatic-x2-top-edge-chamfer-through-prismatic-emitter-lab.mdindex 04c09fe0..de8cc8ac 100644--- a/docs/frictionlab/edge-prismatic-x2-top-edge-chamfer-through-prismatic-emitter-lab.md+++ b/docs/frictionlab/edge-prismatic-x2-top-edge-chamfer-through-prismatic-emitter-lab.md@@ -144,3 +144,8 @@ EDGE-PRISMATIC-X3 confirms that the `PrismaticSectionTransitionEmitter` is not c## V1 packaging statusEDGE-PRISMATIC-V1 is now the preferred reusable seam for this lab witness. X2 remains lab-only and does not route production top-edge chamfers, but its section stack can be emitted through the internal production-adjacent `PrismaticSectionTransitionEmitter` rather than carrying an independent emitter implementation.+++## V2 controlled-route status++EDGE-PRISMATIC-V2 now consumes the packaged `PrismaticSectionTransitionEmitter` through the internal `PrismaticTopEdgeChamferPrototype` route for the same controlled top `+X` horizontal rectangular-prism chamfer. X2 remains lab evidence; V2 is production-adjacent but still not production-authoritative and does not change `ProfileStackExtrudeExecutor`, AirEdgeSweep, `BrepBoundedChamfer`, STEP exporter/importer, Boolean core, or default chamfer/fillet behavior.diff --git a/docs/frictionlab/edge-prismatic-x3-generic-line-profile-transition-lab.md b/docs/frictionlab/edge-prismatic-x3-generic-line-profile-transition-lab.mdindex 1d7cdd11..bdff5bb1 100644--- a/docs/frictionlab/edge-prismatic-x3-generic-line-profile-transition-lab.md+++ b/docs/frictionlab/edge-prismatic-x3-generic-line-profile-transition-lab.md@@ -157,3 +157,8 @@ Do not broaden to arcs, holes, different vertex counts, inferred correspondence,## V1 packaging statusEDGE-PRISMATIC-V1 packages the generic X3 evidence into the internal production-adjacent `PrismaticSectionTransitionEmitter` seam. The rectangle, scaled pentagon, scaled hexagon, and asymmetric translated pentagon cases remain regression evidence for the equal-count line-only first-scope contract.+++## V2 controlled-route status++EDGE-PRISMATIC-V2 uses the V1 packaged emitter for a controlled top-edge chamfer route, while X3 remains the generic equal-count line-only regression evidence that the emitter is not chamfer-specific. V2 does not broaden X3 to arcs, holes, inferred correspondence, arbitrary selection, production route replacement, or public API changes.