Skip to content

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.cs
index 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.md
index 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.md
new file mode 100644
index 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.md
index 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 note
Through-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.md
index 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 note
Through-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.