Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
AIR-V2A.1: stabilize by restoring blind/counterbore AIR deferral
Yuechen Lib41c3b100ccc
diff --git a/Aetheris.Kernel.Firmament.Tests/AirProfileStackExtrudeTests.cs b/Aetheris.Kernel.Firmament.Tests/AirProfileStackExtrudeTests.csindex a4d1c0dc..bf953a44 100644--- a/Aetheris.Kernel.Firmament.Tests/AirProfileStackExtrudeTests.cs+++ b/Aetheris.Kernel.Firmament.Tests/AirProfileStackExtrudeTests.cs@@ -30,35 +30,41 @@ public sealed class AirProfileStackExtrudeTests}[Fact]- public void AirProfileStack_FromHolePlan_Stepped_ConvertsAndExecutes()+ public void ThroughAndStepped_AirRoutesRemainGreen(){- var plan = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(BuildStepped())).Plan!;- Assert.True(AirProfileStackExtrudeAdapter.TryFromHoleRecoveryPlan(plan, out _, out _));- var exec = HoleRecoveryExecutor.Execute(plan);- Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, exec.Status);- Assert.Contains(exec.Diagnostics, x => x.Contains("air-to-profile-stack-executor", StringComparison.Ordinal));+ var through = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(new CirSubtractNode(new CirBoxNode(20,20,10), new CirCylinderNode(2,20)))).Plan!;+ var stepped = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(BuildStepped())).Plan!;+ Assert.True(AirProfileStackExtrudeAdapter.TryFromHoleRecoveryPlan(through, out _, out _));+ Assert.True(AirProfileStackExtrudeAdapter.TryFromHoleRecoveryPlan(stepped, out _, out _));+ Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, HoleRecoveryExecutor.Execute(through).Status);+ Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, HoleRecoveryExecutor.Execute(stepped).Status);}[Fact]- public void AirProfileStack_BlindHole_ExplicitlyDeferredInV1()+ public void BlindHole_AirV2A_FinalRouteStatus(){var plan = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(new CirSubtractNode(new CirBoxNode(20,20,10), new CirTransformNode(new CirCylinderNode(2,4), Transform3D.CreateTranslation(new Vector3D(0,0,3)))))).Plan!;Assert.False(AirProfileStackExtrudeAdapter.TryFromHoleRecoveryPlan(plan, out _, out var d));Assert.Contains(d, x => x.Contains("air-profile-stack-v1-blind-deferred", StringComparison.Ordinal));- Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, HoleRecoveryExecutor.Execute(plan).Status);+ var exec = HoleRecoveryExecutor.Execute(plan);+ Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, exec.Status);+ Assert.Contains(exec.Diagnostics, x => x.Contains("Blind subtract succeeded", StringComparison.Ordinal));}[Fact]- public void AirProfileStack_Counterbore_ExplicitlyDeferredInV1()+ public void Counterbore_AirV2A_FinalRouteStatus(){- var plan = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(new CirSubtractNode(new CirSubtractNode(new CirBoxNode(20,20,10), new CirCylinderNode(2,20)), new CirTransformNode(new CirCylinderNode(4,4), Transform3D.CreateTranslation(new Vector3D(0,0,3)))))).Plan!;+ var root = new CirSubtractNode(new CirSubtractNode(new CirBoxNode(20,20,10), new CirCylinderNode(2,20)), new CirTransformNode(new CirCylinderNode(4,4), Transform3D.CreateTranslation(new Vector3D(0,0,3))));+ var plan = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(root)).Plan!;Assert.False(AirProfileStackExtrudeAdapter.TryFromHoleRecoveryPlan(plan, out _, out var d));Assert.Contains(d, x => x.Contains("air-profile-stack-v1-counterbore-deferred", StringComparison.Ordinal));- Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, HoleRecoveryExecutor.Execute(plan).Status);+ var exec = HoleRecoveryExecutor.Execute(plan);+ Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, exec.Status);+ Assert.Contains(exec.Diagnostics, x => x.Contains("Second subtract succeeded", StringComparison.Ordinal));}[Fact]- public void AirProfileStack_ConicalVariants_DeferredInV1()+ public void ConicalRoutesRemainConical(){var root = new CirSubtractNode(new CirSubtractNode(new CirBoxNode(20,20,10), new CirCylinderNode(2,20)), new CirTransformNode(new CirConeNode(2, 4, 4), Transform3D.CreateTranslation(new Vector3D(0, 0, 3))));var plan = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(root)).Plan!;@@ -68,7 +74,7 @@ public sealed class AirProfileStackExtrudeTests}[Fact]- public void AirProfileStack_InvalidLayerOrdering_RejectsBeforeEmitter()+ public void NoHoleLayer_CurrentExpectedBehavior(){var air = new AirProfileStackExtrude([new AirProfileStackLayer(-5,0,new AirProfileRegion2D(new AirRectangleProfile(20,20),new AirCenteredCircleLoop(2),"a",[]),"a",[]),diff --git a/docs/air-v1-profile-stack-extrude-production-scaffold.md b/docs/air-v1-profile-stack-extrude-production-scaffold.mdindex 8bdd70a8..ce06e1c0 100644--- a/docs/air-v1-profile-stack-extrude-production-scaffold.md+++ b/docs/air-v1-profile-stack-extrude-production-scaffold.md@@ -60,3 +60,7 @@ No emitter rewrite was done. BRep/STEP behavior remains on existing production e- Introduce AIR execution semantics for blind/counterbore no-hole/overlap intervals.- Add explicit conical profile region for countersink/chamfer adaptation.+++## AIR-V2A.1 update (2026-05-23)+Blind-hole and counterbore remain explicitly deferred in AIR; legacy bounded routes are preserved to keep gates green.diff --git a/docs/air-v2a-blind-counterbore-profile-stack-support.md b/docs/air-v2a-blind-counterbore-profile-stack-support.mdnew file mode 100644index 00000000..80d04ecd--- /dev/null+++ b/docs/air-v2a-blind-counterbore-profile-stack-support.md@@ -0,0 +1,33 @@+# AIR-V2A / V2A.1: cylindrical blind-hole and counterbore profile-stack stabilization++## Scope+AIR-V2A attempted to migrate cylindrical blind-hole and counterbore execution to the AIR/profile-stack route used by through and stepped holes.++AIR-V2A.1 stabilizes the branch and restores test gates.++## Final route status after V2A.1+- Through-hole: AIR/profile-stack route active and executable.+- Stepped-hole: AIR/profile-stack route active and executable.+- Blind-hole: AIR route explicitly deferred; legacy bounded placement-driven blind route remains executable.+- Counterbore: AIR route explicitly deferred; legacy bounded counterbore route remains executable.+- Countersink/chamfered-entry: conical route preserved; AIR conical deferral preserved.++## Why blind/counterbore are deferred in V2A.1+The attempted AIR layer normalization for blind/counterbore caused focused Firmament regressions (counterbore execution `BooleanFailed`, blind-bottom manifold/void regressions, and cascading rematerializer/matrix failures).++V2A.1 therefore restores explicit deferral diagnostics and preserves proven legacy execution for these two variants.++## Diagnostics+Preserved defer breadcrumbs:+- `air-profile-stack-v1-blind-deferred`+- `air-profile-stack-v1-counterbore-deferred`+- `air-profile-stack-v1-conical-deferred`++## Non-goals+- no conical AIR migration,+- no arbitrary profile/loop support,+- no STEP exporter behavior changes,+- no public API/CLI expansion.++## Recommended next step+AIR-V2B should investigate bounded emitter support for blind/counterbore interval topology with dedicated composition constraints and diagnostics before re-enabling AIR routing for these variants.diff --git a/docs/cir-recovery-v19-hole-family-capability-manifest.md b/docs/cir-recovery-v19-hole-family-capability-manifest.mdindex 8e06f7a2..cbf5e9e4 100644--- a/docs/cir-recovery-v19-hole-family-capability-manifest.md+++ b/docs/cir-recovery-v19-hole-family-capability-manifest.md@@ -196,3 +196,7 @@ Candidate next labs (user-prioritized):## AIR-V1 noteThrough-hole and stepped-hole profile-stack routes now materialize a bounded AIR scaffold (`AirProfileStackExtrude`) before executor emission. Blind/counterbore/conical variants are explicitly deferred in AIR-V1 and remain on their legacy executor routes.+++## AIR-V2A.1 update (2026-05-23)+Capability manifest correction: blind-hole and counterbore remain AIR-deferred and execute via legacy bounded routes. Through/stepped remain on AIR/profile-stack; conical variants remain AIR-deferred.diff --git a/docs/cir-sweep-v2-cylindrical-hole-profile-stack-migration.md b/docs/cir-sweep-v2-cylindrical-hole-profile-stack-migration.mdindex 884b71bd..390fdaae 100644--- a/docs/cir-sweep-v2-cylindrical-hole-profile-stack-migration.md+++ b/docs/cir-sweep-v2-cylindrical-hole-profile-stack-migration.md@@ -59,3 +59,7 @@ CIR-SWEEP-V3 can evaluate conical profile-stack/revolve/sweep route candidates f## AIR-V1 noteThrough-hole and stepped-hole profile-stack routes now materialize a bounded AIR scaffold (`AirProfileStackExtrude`) before executor emission. Blind/counterbore/conical variants are explicitly deferred in AIR-V1 and remain on their legacy executor routes.+++## AIR-V2A.1 update (2026-05-23)+Through/stepped remain AIR/profile-stack. Blind/counterbore are explicitly deferred in AIR with legacy bounded execution retained; countersink/chamfer remain conical route.