Skip to content

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.cs
new file mode 100644
index 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.cs
new file mode 100644
index 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.md
index 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 plana
Legacy 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 note
The 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.md
index 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.md
new file mode 100644
index 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.md
index 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 status
EDGE-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.md
index 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 status
EDGE-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.