Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Add generic prismatic polygon transition lab

Yuechen Li24b0c4d50a1e
diff --git a/Aetheris.Firmament.FrictionLab/CIRLab/PrismaticSectionTransitionEmitterLab.cs b/Aetheris.Firmament.FrictionLab/CIRLab/PrismaticSectionTransitionEmitterLab.cs
index e4b1105e..11292d01 100644
--- a/Aetheris.Firmament.FrictionLab/CIRLab/PrismaticSectionTransitionEmitterLab.cs
+++ b/Aetheris.Firmament.FrictionLab/CIRLab/PrismaticSectionTransitionEmitterLab.cs
@@ -62,6 +62,7 @@ public static class PrismaticSectionTransitionEmitterLab
public static readonly string[] AllowedRecommendations =
[
"prismatic-section-transition-ready-for-production-evaluation",
+ "prismatic-section-transition-generic-ready-for-production-evaluation",
"prismatic-section-transition-needs-profile-validation-hardening",
"prismatic-section-transition-needs-correspondence-hardening",
"prismatic-section-transition-invalid-rejected",
@@ -76,6 +77,8 @@ public static class PrismaticSectionTransitionEmitterLab
Run(RectangleToInsetRectangle()),
Run(ThreeSectionStableThenInsetRectangle()),
Run(ScaledPentagon()),
+ Run(ScaledHexagon()),
+ Run(AsymmetricTranslatedPentagon()),
Run(new("invalid-non-increasing-z", [RectangleSection(0, 10, 8), RectangleSection(0, 8, 6)], PrismaticCorrespondenceMap.Identity(4))),
Run(new("invalid-mismatched-vertex-count", [RectangleSection(0, 10, 8), RegularPolygonSection(1, 5, 5)], PrismaticCorrespondenceMap.Identity(4))),
Run(new("invalid-missing-correspondence", [RectangleSection(0, 10, 8), RectangleSection(1, 8, 6)], null)),
@@ -94,9 +97,25 @@ public static class PrismaticSectionTransitionEmitterLab
public static PrismaticSectionTransitionCase ScaledPentagon() =>
new("scaled-pentagon", [RegularPolygonSection(0, 5, 5), RegularPolygonSection(2, 4, 5)], PrismaticCorrespondenceMap.Identity(5));
+ public static PrismaticSectionTransitionCase ScaledHexagon() =>
+ new("scaled-hexagon", [RegularPolygonSection(0, 6, 6), RegularPolygonSection(2, 4.5, 6)], PrismaticCorrespondenceMap.Identity(6));
+
+ public static PrismaticSectionTransitionCase AsymmetricTranslatedPentagon() =>
+ new("asymmetric-translated-pentagon",
+ [
+ new PrismaticSection(0, [(-4, -2), (1, -3), (5, 0), (2, 3.5), (-3, 2.5)]),
+ new PrismaticSection(2, [(-3.25, -2.35), (1.75, -3.35), (5.75, -0.35), (2.75, 3.15), (-2.25, 2.15)]),
+ ],
+ PrismaticCorrespondenceMap.Identity(5));
+
public static PrismaticSectionTransitionRow Run(PrismaticSectionTransitionCase c)
{
- var diagnostics = new List<string> { "edge-prismatic-x1-lab-started" };
+ var diagnostics = new List<string>
+ {
+ "edge-prismatic-x1-lab-started",
+ "edge-prismatic-x3-generic-lab-started",
+ $"edge-prismatic-x3-case-started:{c.Name}",
+ };
var validation = Validate(c, diagnostics);
if (validation.Status != LabProfileStatus.Succeeded)
{
@@ -104,11 +123,14 @@ public static class PrismaticSectionTransitionEmitterLab
}
diagnostics.Add("edge-prismatic-x1-correspondence-created");
+ diagnostics.Add("edge-prismatic-x3-correspondence-created");
+ diagnostics.Add("edge-prismatic-x3-section-stack-created");
for (var i = 0; i < c.Sections.Count - 1; i++)
{
diagnostics.Add("edge-prismatic-x1-transition-interval-created");
}
+ diagnostics.Add("edge-prismatic-x3-prismatic-emitter-invoked");
var built = PrismaticSectionTransitionEmitter.TryEmit(c.Sections, c.Correspondence!);
if (built.Body is null)
{
@@ -119,15 +141,21 @@ public static class PrismaticSectionTransitionEmitterLab
diagnostics.Add("edge-prismatic-x1-cap-faces-created");
diagnostics.Add("edge-prismatic-x1-transition-faces-created");
diagnostics.Add("edge-prismatic-x1-body-created");
+ diagnostics.Add("edge-prismatic-x3-body-created");
diagnostics.Add("edge-prismatic-x1-no-air-edge-sweep-used");
+ diagnostics.Add("edge-prismatic-x3-no-air-edge-sweep-used");
diagnostics.Add("edge-prismatic-x1-no-brep-bounded-chamfer-used");
+ diagnostics.Add("edge-prismatic-x3-no-brep-bounded-chamfer-used");
diagnostics.Add("edge-prismatic-x1-no-topology-graft-used");
+ diagnostics.Add("edge-prismatic-x3-no-topology-graft-used");
diagnostics.Add("edge-prismatic-x1-no-3d-boolean-used");
+ diagnostics.Add("edge-prismatic-x3-no-3d-boolean-used");
var topology = SummarizeTopology(built.Body, c.Sections);
var step = SummarizeStep(built.Body);
var stepSucceeded = step.Exported && step.MissingRequiredMarkers.Count == 0 && step.UnexpectedPresentMarkers.Count == 0;
diagnostics.Add(stepSucceeded ? "edge-prismatic-x1-step-smoke-succeeded" : "edge-prismatic-x1-step-smoke-failed:markers");
+ diagnostics.Add(stepSucceeded ? "edge-prismatic-x3-step-smoke-succeeded" : "edge-prismatic-x3-step-smoke-failed:markers");
var n = c.Sections[0].OuterLoop.Count;
var sectionCount = c.Sections.Count;
@@ -145,6 +173,11 @@ public static class PrismaticSectionTransitionEmitterLab
&& topology.LoopCount == expectedFaces
&& topology.CoedgeCount == (2 * n) + (4 * (sectionCount - 1) * n);
+ if (topologySucceeded)
+ {
+ diagnostics.Add("edge-prismatic-x3-topology-formula-validated");
+ }
+
return new(
c.Name,
LabProfileStatus.Succeeded,
@@ -153,7 +186,7 @@ public static class PrismaticSectionTransitionEmitterLab
step,
StableDiagnostics(diagnostics),
topologySucceeded && stepSucceeded
- ? "prismatic-section-transition-ready-for-production-evaluation"
+ ? "prismatic-section-transition-generic-ready-for-production-evaluation"
: "prismatic-section-transition-needs-profile-validation-hardening");
}
@@ -162,6 +195,7 @@ public static class PrismaticSectionTransitionEmitterLab
if (c.Sections.Count is < 2 or > 3)
{
diagnostics.Add("edge-prismatic-x1-invalid-section-rejected");
+ diagnostics.Add("edge-prismatic-x3-invalid-profile-rejected");
return (LabProfileStatus.Failed, "prismatic-section-transition-invalid-rejected");
}
@@ -170,24 +204,28 @@ public static class PrismaticSectionTransitionEmitterLab
if (section.HasHoles)
{
diagnostics.Add("edge-prismatic-x1-holes-deferred");
+ diagnostics.Add("edge-prismatic-x3-holes-deferred");
return (LabProfileStatus.Deferred, "prismatic-section-transition-deferred");
}
if (section.HasArcs)
{
diagnostics.Add("edge-prismatic-x1-line-arc-deferred");
+ diagnostics.Add("edge-prismatic-x3-line-arc-deferred");
return (LabProfileStatus.Deferred, "prismatic-section-transition-deferred");
}
if (section.OuterLoopCount != 1)
{
diagnostics.Add("edge-prismatic-x1-multiple-loops-deferred");
+ diagnostics.Add("edge-prismatic-x3-multiple-loops-deferred");
return (LabProfileStatus.Deferred, "prismatic-section-transition-deferred");
}
if (!ValidateProfile(section, out var profileDiagnostic))
{
diagnostics.Add(profileDiagnostic);
+ diagnostics.Add("edge-prismatic-x3-invalid-profile-rejected");
return (LabProfileStatus.Failed, "prismatic-section-transition-invalid-rejected");
}
@@ -199,12 +237,14 @@ public static class PrismaticSectionTransitionEmitterLab
if (!double.IsFinite(c.Sections[i].Z))
{
diagnostics.Add("edge-prismatic-x1-invalid-section-rejected");
+ diagnostics.Add("edge-prismatic-x3-invalid-profile-rejected");
return (LabProfileStatus.Failed, "prismatic-section-transition-invalid-rejected");
}
if (i > 0 && c.Sections[i].Z <= c.Sections[i - 1].Z + Tol)
{
diagnostics.Add("edge-prismatic-x1-non-increasing-sections-rejected");
+ diagnostics.Add("edge-prismatic-x3-non-increasing-sections-rejected");
return (LabProfileStatus.Failed, "prismatic-section-transition-invalid-rejected");
}
}
@@ -213,6 +253,7 @@ public static class PrismaticSectionTransitionEmitterLab
if (c.Sections.Any(s => s.OuterLoop.Count != vertexCount))
{
diagnostics.Add("edge-prismatic-x1-mismatched-vertex-count-rejected");
+ diagnostics.Add("edge-prismatic-x3-mismatched-vertex-count-rejected");
return (LabProfileStatus.Failed, "prismatic-section-transition-invalid-rejected");
}
@@ -220,18 +261,21 @@ public static class PrismaticSectionTransitionEmitterLab
if (c.Sections.Skip(1).Any(s => (SignedArea(s.OuterLoop) > 0d) != orientation))
{
diagnostics.Add("edge-prismatic-x1-invalid-profile-rejected");
+ diagnostics.Add("edge-prismatic-x3-invalid-profile-rejected");
return (LabProfileStatus.Failed, "prismatic-section-transition-invalid-rejected");
}
if (c.Correspondence is null || c.Correspondence.VertexMap.Count != vertexCount || !c.Correspondence.VertexMap.SequenceEqual(Enumerable.Range(0, vertexCount)))
{
diagnostics.Add("edge-prismatic-x1-missing-correspondence-rejected");
+ diagnostics.Add("edge-prismatic-x3-missing-correspondence-rejected");
return (LabProfileStatus.Failed, c.Correspondence is null ? "prismatic-section-transition-invalid-rejected" : "prismatic-section-transition-needs-correspondence-hardening");
}
if (!AllTransitionFacesPlanar(c.Sections))
{
diagnostics.Add("edge-prismatic-x1-invalid-profile-rejected");
+ diagnostics.Add("edge-prismatic-x3-invalid-profile-rejected");
return (LabProfileStatus.Failed, "prismatic-section-transition-needs-profile-validation-hardening");
}
diff --git a/Aetheris.FrictionLab.Tests/CIRLab/PrismaticSectionTransitionEmitterLabTests.cs b/Aetheris.FrictionLab.Tests/CIRLab/PrismaticSectionTransitionEmitterLabTests.cs
index 8b1454aa..ddd50ffd 100644
--- a/Aetheris.FrictionLab.Tests/CIRLab/PrismaticSectionTransitionEmitterLabTests.cs
+++ b/Aetheris.FrictionLab.Tests/CIRLab/PrismaticSectionTransitionEmitterLabTests.cs
@@ -82,6 +82,73 @@ public sealed class PrismaticSectionTransitionEmitterLabTests
Assert.Contains("edge-prismatic-x1-no-3d-boolean-used", row.Diagnostics);
}
+ [Theory]
+ [InlineData("scaled-pentagon", 5, 10, 15, 7, 30, "[-4.755,-5,0]..[4.755,4.045,2]")]
+ [InlineData("scaled-hexagon", 6, 12, 18, 8, 36, "[-5.196,-6,0]..[5.196,6,2]")]
+ [InlineData("asymmetric-translated-pentagon", 5, 10, 15, 7, 30, "[-4,-3.35,0]..[5.75,3.5,2]")]
+ public void GenericTwoSectionPolygonCases_ValidateTopologyFormulaAndStepSmoke(
+ string caseName,
+ int vertexCount,
+ int expectedVertices,
+ int expectedEdges,
+ int expectedFaces,
+ int expectedCoedges,
+ string expectedBounds)
+ {
+ var row = PrismaticSectionTransitionEmitterLab.RunAll().Single(x => x.CaseName == caseName);
+
+ Assert.True(row.Succeeded);
+ Assert.Equal(LabProfileStatus.Succeeded, row.Status);
+ Assert.True(row.Topology.BodyProduced);
+ Assert.Equal(2, row.Topology.SectionCount);
+ Assert.Equal(expectedVertices, row.Topology.VertexCount);
+ Assert.Equal(expectedEdges, row.Topology.EdgeCount);
+ Assert.Equal(vertexCount, row.Topology.BottomProfileEdgeCount);
+ Assert.Equal(vertexCount, row.Topology.TopProfileEdgeCount);
+ Assert.Equal(vertexCount, row.Topology.TransitionEdgeCount);
+ Assert.Equal(2, row.Topology.CapFaceCount);
+ Assert.Equal(vertexCount, row.Topology.TransitionFaceCount);
+ Assert.Equal(0, row.Topology.StableIntervalFaceCount);
+ Assert.Equal(vertexCount, row.Topology.ChangedIntervalFaceCount);
+ Assert.Equal(expectedFaces, row.Topology.FaceCount);
+ Assert.Equal(expectedFaces, row.Topology.PlanarFaceCount);
+ Assert.Equal(0, row.Topology.CylindricalFaceCount);
+ Assert.Equal(expectedFaces, row.Topology.LoopCount);
+ Assert.Equal(expectedCoedges, row.Topology.CoedgeCount);
+ Assert.Equal(expectedBounds, row.Topology.Bounds);
+ Assert.True(row.Step.Exported);
+ Assert.Empty(row.Step.MissingRequiredMarkers);
+ Assert.Empty(row.Step.UnexpectedPresentMarkers);
+ Assert.Contains("ISO-10303-21", row.Step.PresentMarkers);
+ Assert.Contains("MANIFOLD_SOLID_BREP", row.Step.PresentMarkers);
+ Assert.Contains("ADVANCED_FACE", row.Step.PresentMarkers);
+ Assert.Contains("PLANE", row.Step.PresentMarkers);
+ Assert.Contains("CYLINDRICAL_SURFACE", row.Step.AbsentMarkers);
+ Assert.Contains("BREP_WITH_VOIDS", row.Step.AbsentMarkers);
+ Assert.Contains("edge-prismatic-x3-topology-formula-validated", row.Diagnostics);
+ Assert.Equal("prismatic-section-transition-generic-ready-for-production-evaluation", row.Recommendation);
+ }
+
+ [Fact]
+ public void GenericLabDiagnostics_ConfirmNoLegacyRoutesOrBooleanRoutes()
+ {
+ var rows = PrismaticSectionTransitionEmitterLab.RunAll().Where(x => x.Succeeded).ToArray();
+
+ Assert.NotEmpty(rows);
+ foreach (var row in rows)
+ {
+ Assert.Contains("edge-prismatic-x3-prismatic-emitter-invoked", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-section-stack-created", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-correspondence-created", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-body-created", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-step-smoke-succeeded", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-no-air-edge-sweep-used", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-no-brep-bounded-chamfer-used", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-no-topology-graft-used", row.Diagnostics);
+ Assert.Contains("edge-prismatic-x3-no-3d-boolean-used", row.Diagnostics);
+ }
+ }
+
[Fact]
public void ThreeSectionStablePlusTransition_EmitsSplitIntervalFacesWithDocumentedTopology()
{
@@ -132,6 +199,23 @@ public sealed class PrismaticSectionTransitionEmitterLabTests
Assert.Equal(recommendation, row.Recommendation);
}
+ [Theory]
+ [InlineData("invalid-non-increasing-z", "edge-prismatic-x3-non-increasing-sections-rejected")]
+ [InlineData("invalid-mismatched-vertex-count", "edge-prismatic-x3-mismatched-vertex-count-rejected")]
+ [InlineData("invalid-missing-correspondence", "edge-prismatic-x3-missing-correspondence-rejected")]
+ [InlineData("invalid-self-intersecting-profile", "edge-prismatic-x3-invalid-profile-rejected")]
+ [InlineData("deferred-holes", "edge-prismatic-x3-holes-deferred")]
+ [InlineData("deferred-line-arc", "edge-prismatic-x3-line-arc-deferred")]
+ [InlineData("deferred-multiple-loops", "edge-prismatic-x3-multiple-loops-deferred")]
+ public void GenericInvalidAndDeferredCases_RejectOrDeferBeforeEmission(string caseName, string diagnostic)
+ {
+ var row = PrismaticSectionTransitionEmitterLab.RunAll().Single(x => x.CaseName == caseName);
+
+ Assert.False(row.Succeeded);
+ Assert.DoesNotContain("edge-prismatic-x3-prismatic-emitter-invoked", row.Diagnostics);
+ Assert.Contains(diagnostic, row.Diagnostics);
+ }
+
[Fact]
public void RecommendationVocabulary_IsFiniteAndDeterministic()
{
diff --git a/docs/edge-prismatic-a0-section-transition-contract-audit.md b/docs/edge-prismatic-a0-section-transition-contract-audit.md
index f91ab629..479fef7f 100644
--- a/docs/edge-prismatic-a0-section-transition-contract-audit.md
+++ b/docs/edge-prismatic-a0-section-transition-contract-audit.md
@@ -439,3 +439,11 @@ This is evidence for the contract only. It does not change production chamfer/fi
EDGE-PRISMATIC-X2 now implements the audit's proposed top-edge chamfer follow-up. The lab builds the canonical EDGE-PROFILE-X2 three-section stack, uses explicit identity correspondence, invokes the EDGE-PRISMATIC-X1 `PrismaticSectionTransitionEmitter`, classifies the changed `+X` transition face as the chamfer face, and preserves the expected split topology: 12 vertices, 20 edges, 10 planar faces, 0 cylindrical faces, 10 loops, and 40 coedges.
The result confirms the intended ownership split: this top/horizontal history-known chamfer belongs to the prismatic section-transition lane, not AirEdgeSweep, `BrepBoundedChamfer`, topology grafting, or 3D Boolean fallback. It remains lab-only and does not broaden `ProfileStackExtrudeExecutor` or production chamfer/fillet behavior.
+
+## 15. EDGE-PRISMATIC-X3 implementation note
+
+EDGE-PRISMATIC-X3 now broadens the contract evidence with a lab-only generic polygon transition row set. Successful rows cover rectangle-to-inset-rectangle, scaled pentagon, scaled hexagon, and asymmetric translated pentagon cases with equal vertex counts, line-only outer loops, explicit identity correspondence, planar transition faces, closed BRep emission, and STEP smoke through the existing exporter.
+
+The observed two-section topology convention matches the audit formula: `vertices = 2n`, `edges = 3n`, `faces = n + 2`, `planar faces = n + 2`, `cylindrical faces = 0`, `loops = n + 2`, and `coedges = 6n`. Invalid/deferred rows still reject or defer before emission for mismatched counts, missing correspondence, invalid profiles, non-increasing/zero section spans, holes, line+arc markers, and multiple-loop markers.
+
+This remains contract evidence only. It does not change production chamfer/fillet behavior, production route selection, `ProfileStackExtrudeExecutor`, AirEdgeSweep, `BrepBoundedChamfer`, STEP exporter/importer code, Boolean core code, triangle migration, sketch solving, clipping, or NURBS/freeform support.
diff --git a/docs/frictionlab/edge-prismatic-x1-section-transition-emitter-lab.md b/docs/frictionlab/edge-prismatic-x1-section-transition-emitter-lab.md
index 5480a949..aeff4ea2 100644
--- a/docs/frictionlab/edge-prismatic-x1-section-transition-emitter-lab.md
+++ b/docs/frictionlab/edge-prismatic-x1-section-transition-emitter-lab.md
@@ -216,3 +216,7 @@ The safer sequencing is EDGE-PRISMATIC-X2 first, because it would prove that the
EDGE-PRISMATIC-X2 uses the X1 `PrismaticSectionTransitionEmitter` to reproduce the EDGE-PROFILE-X2 top `+X` horizontal edge chamfer witness. The X2 lab supplies the exact three-section stack, identity correspondence, split transition intervals, and chamfer transition-face classification expected by the top-edge chamfer contract.
The X2 result confirms that the emitter is a real client path for the top-edge chamfer fixture while preserving the X1 constraints: lab-only, line-only profiles, equal vertex counts, explicit correspondence, all-planar closed BRep emission, STEP smoke, and no AirEdgeSweep, `BrepBoundedChamfer`, topology graft/body mutation, or 3D Boolean.
+
+## 13. EDGE-PRISMATIC-X3 follow-up
+
+EDGE-PRISMATIC-X3 broadens the X1 evidence from rectangle and first pentagon rows into a generic line-only equal-count polygon transition lab. It adds deterministic two-section pentagon, hexagon, and asymmetric translated-polygon rows, validates the two-section topology formula (`vertices = 2n`, `edges = 3n`, `faces = n + 2`, `coedges = 6n`), and preserves the same lab-only no-AirEdgeSweep/no-BrepBoundedChamfer/no-graft/no-3D-Boolean constraints.
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 9ea4aa0a..8efa027b 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
@@ -136,3 +136,7 @@ Two reasonable follow-up milestones are:
2. **EDGE-PRISMATIC-X3 generic polygon transition lab**: broaden evidence first with additional line-only equal-count polygon transitions and harder correspondence diagnostics before production-adjacent packaging.
If broader evidence is desired before route admission, X3 is the safer next step. If the only target is the canonical history-known top-edge chamfer family, V1 packaging can be evaluated next with strict gating.
+
+## 12. EDGE-PRISMATIC-X3 follow-up
+
+EDGE-PRISMATIC-X3 confirms that the `PrismaticSectionTransitionEmitter` is not chamfer-specific. The generic lab emits rectangle-to-inset-rectangle, scaled pentagon, scaled hexagon, and asymmetric equal-count polygon transitions through the same direct prismatic emitter path, with STEP smoke and topology-formula validation, while leaving X2's top-edge chamfer witness and all production chamfer/fillet behavior unchanged.
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
new file mode 100644
index 00000000..a818645f
--- /dev/null
+++ b/docs/frictionlab/edge-prismatic-x3-generic-line-profile-transition-lab.md
@@ -0,0 +1,155 @@
+# EDGE-PRISMATIC-X3 — Generic line-only profile transition lab
+
+## 1. Purpose and scope
+
+EDGE-PRISMATIC-X3 broadens the lab evidence for `PrismaticSectionTransitionEmitter` beyond the top-edge chamfer witness. The lab remains intentionally bounded: it covers Z-axis, line-only, one-outer-loop polygon section transitions with equal vertex counts and explicit identity-by-index correspondence.
+
+This is lab-only evidence. It does not production-route the emitter and does not change production chamfer/fillet behavior, public APIs, the STEP exporter/importer, Boolean core, AirEdgeSweep, `BrepBoundedChamfer`, current `ProfileStackExtrudeExecutor` behavior, triangle migration, sketch solving, clipping, or NURBS/freeform support.
+
+## 2. References
+
+- `docs/edge-prismatic-a0-section-transition-contract-audit.md` defines the prismatic section-transition contract and first-scope exclusions.
+- `docs/frictionlab/edge-prismatic-x1-section-transition-emitter-lab.md` introduces the lab-only emitter and the rectangle/three-section first proof.
+- `docs/frictionlab/edge-prismatic-x2-top-edge-chamfer-through-prismatic-emitter-lab.md` routes the top `+X` chamfer witness through that emitter.
+
+## 3. Generic proof claim
+
+X3 proves that the emitter is generic for bounded equal-count line-only prismatic section transitions, not merely a top-edge chamfer path. The successful rows all use the same direct emitter route:
+
+1. create a finite section stack;
+2. require one line-only outer loop per section;
+3. require equal vertex counts;
+4. require explicit identity correspondence;
+5. verify every transition quad is planar;
+6. emit a closed BRep directly;
+7. export through the existing `Step242Exporter`;
+8. assert topology and STEP smoke markers.
+
+The lab records `edge-prismatic-x3-prismatic-emitter-invoked` for successful rows and records no-use diagnostics for AirEdgeSweep, `BrepBoundedChamfer`, topology grafting, and 3D Boolean routes.
+
+## 4. Cases tested
+
+### Case A — rectangle to centered inset rectangle
+
+- `z0 = 0`, bottom rectangle width `10`, depth `8`.
+- `z1 = 1`, top rectangle width `8`, depth `6`.
+- Vertex count: `n = 4`.
+- Result: `8` vertices, `12` edges, `6` faces, `6` planar faces, `0` cylindrical faces, `2` cap faces, `4` transition faces, `24` coedges.
+
+### Case B — pentagon to scaled pentagon
+
+- `z0 = 0`, deterministic regular pentagon radius `5`.
+- `z1 = 2`, same-center pentagon radius `4`.
+- Vertex count: `n = 5`.
+- Result: `10` vertices, `15` edges, `7` faces, `7` planar faces, `0` cylindrical faces, `2` cap faces, `5` transition faces, `30` coedges.
+
+### Case C — hexagon to scaled hexagon
+
+- `z0 = 0`, deterministic regular hexagon radius `6`.
+- `z1 = 2`, same-center hexagon radius `4.5`.
+- Vertex count: `n = 6`.
+- Result: `12` vertices, `18` edges, `8` faces, `8` planar faces, `0` cylindrical faces, `2` cap faces, `6` transition faces, `36` coedges.
+
+### Case D — asymmetric equal-count polygon
+
+- `z0 = 0`, deterministic five-vertex asymmetric polygon.
+- `z1 = 2`, the same polygon translated in XY by `(0.75, -0.35)`.
+- Vertex count: `n = 5`.
+- Result: `10` vertices, `15` edges, `7` faces, `7` planar faces, `0` cylindrical faces, `2` cap faces, `5` transition faces, `30` coedges.
+
+Case D is intentionally not a regular or uniform-scale shape. It demonstrates that explicit correspondence, not symmetry, drives emission. The translation keeps corresponding edges parallel, so each transition quad remains planar under the X3 first-scope rules.
+
+### Three-section retained evidence
+
+The X1 three-section stable-lower-interval plus changed-upper-profile row remains in `RunAll()` and continues to validate split interval topology. X3's generic formula assertions focus on two-section cases; the three-section row preserves the broader section-stack evidence without changing production routing.
+
+## 5. Topology formula
+
+For every successful two-section line-only transition with `n` vertices:
+
+- vertices: `2n`;
+- edges: `3n`;
+ - `n` bottom profile edges;
+ - `n` top profile edges;
+ - `n` transition edges;
+- faces: `n + 2`;
+ - `2` cap faces;
+ - `n` transition faces;
+- planar faces: `n + 2`;
+- cylindrical faces: `0`;
+- loops: `n + 2`, because the lab emits one loop per face;
+- coedges: `6n`, because the lab emits `4n` coedges for the quad transition faces and `2n` coedges for the two polygon caps.
+
+The test suite asserts this formula for rectangle, pentagon, hexagon, and asymmetric polygon rows and records `edge-prismatic-x3-topology-formula-validated` for successful rows.
+
+For `S` sections, the current emitter's documented convention remains:
+
+- vertices: `S * n`;
+- profile edges: `S * n`;
+- transition edges: `(S - 1) * n`;
+- total edges: `(S * n) + ((S - 1) * n)`;
+- faces/loops: `2 + ((S - 1) * n)`;
+- coedges: `(2 * n) + (4 * (S - 1) * n)`.
+
+## 6. STEP smoke findings
+
+Successful X3 rows export through the existing `Step242Exporter` without exporter changes.
+
+Required markers present:
+
+- `ISO-10303-21`;
+- `MANIFOLD_SOLID_BREP`;
+- `ADVANCED_FACE`;
+- `PLANE`.
+
+Required markers absent:
+
+- `CYLINDRICAL_SURFACE`;
+- `BREP_WITH_VOIDS`.
+
+The lab records `edge-prismatic-x3-step-smoke-succeeded` for successful rows.
+
+## 7. Invalid and deferred cases
+
+Invalid/deferred rows are classified before emitter invocation. The machine-checkable X3 diagnostics are:
+
+- mismatched vertex counts: `edge-prismatic-x3-mismatched-vertex-count-rejected`;
+- missing correspondence: `edge-prismatic-x3-missing-correspondence-rejected`;
+- invalid/self-intersecting profile: `edge-prismatic-x3-invalid-profile-rejected`;
+- non-increasing or zero interval span: `edge-prismatic-x3-non-increasing-sections-rejected`;
+- holes: `edge-prismatic-x3-holes-deferred`;
+- line+arc profiles: `edge-prismatic-x3-line-arc-deferred`;
+- multiple outer loops: `edge-prismatic-x3-multiple-loops-deferred`.
+
+The finite recommendation vocabulary now includes the generic success recommendation:
+
+- `prismatic-section-transition-generic-ready-for-production-evaluation`;
+- `prismatic-section-transition-ready-for-production-evaluation` for the older X1 vocabulary entry;
+- `prismatic-section-transition-needs-correspondence-hardening`;
+- `prismatic-section-transition-needs-profile-validation-hardening`;
+- `prismatic-section-transition-invalid-rejected`;
+- `prismatic-section-transition-deferred`.
+
+## 8. No-trim/no-graft/no-legacy-route guarantee
+
+Successful rows include deterministic diagnostics confirming:
+
+- `edge-prismatic-x3-no-air-edge-sweep-used`;
+- `edge-prismatic-x3-no-brep-bounded-chamfer-used`;
+- `edge-prismatic-x3-no-topology-graft-used`;
+- `edge-prismatic-x3-no-3d-boolean-used`.
+
+The lab does not use trim/graft/body mutation, AirEdgeSweep, `BrepBoundedChamfer`, 3D Boolean, a sketch solver, a clipping engine, arcs, holes, inferred correspondence, or NURBS/freeform support.
+
+## 9. Relationship to current ProfileStackExtrudeExecutor
+
+`ProfileStackExtrudeExecutor` remains unchanged and is not replaced. X3 is evidence for a lab-only section-transition emitter and does not route production profile-stack, chamfer, or fillet behavior through it.
+
+## 10. Recommendation for next milestone
+
+X3 supports `prismatic-section-transition-generic-ready-for-production-evaluation` for the bounded line-only equal-count cases. Recommended next steps are:
+
+1. **EDGE-PRISMATIC-V1 production-adjacent emitter packaging** if production-adjacent gating, validation hardening, ownership, and route admission are explicitly scoped without changing default behavior.
+2. **EDGE-PRISMATIC-X4 coplanar split/merge policy audit** if the next uncertainty is whether stable and changed coplanar interval faces should remain split or be merged for production-adjacent output.
+
+Do not broaden to arcs, holes, different vertex counts, inferred correspondence, clipping, sketch solving, or NURBS/freeform support as part of this X3 result.