Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Re-enable stepped executor with explicit placement validation

Yuechen Li0820c294665f
diff --git a/Aetheris.Kernel.Firmament.Tests/FrepSemanticRecoveryRematerializerTests.cs b/Aetheris.Kernel.Firmament.Tests/FrepSemanticRecoveryRematerializerTests.cs
index c6cc3ed4..8a2a70dd 100644
--- a/Aetheris.Kernel.Firmament.Tests/FrepSemanticRecoveryRematerializerTests.cs
+++ b/Aetheris.Kernel.Firmament.Tests/FrepSemanticRecoveryRematerializerTests.cs
@@ -82,7 +82,6 @@ public sealed class FrepSemanticRecoveryRematerializerTests
Assert.False(result.Succeeded);
Assert.Null(result.Body);
Assert.Contains(result.Diagnostics, d => d.Contains("executor failed", StringComparison.Ordinal));
- Assert.Contains(result.Diagnostics, d => d.Contains("stepped-execution-route-disabled-until-v13.3", StringComparison.Ordinal));
}
private static NativeGeometryReplayLog BuildReplay(string toolKind)
=> new([
diff --git a/Aetheris.Kernel.Firmament.Tests/HoleRecoveryPolicyCoverageMatrixTests.cs b/Aetheris.Kernel.Firmament.Tests/HoleRecoveryPolicyCoverageMatrixTests.cs
index 4feacee1..9739f425 100644
--- a/Aetheris.Kernel.Firmament.Tests/HoleRecoveryPolicyCoverageMatrixTests.cs
+++ b/Aetheris.Kernel.Firmament.Tests/HoleRecoveryPolicyCoverageMatrixTests.cs
@@ -107,8 +107,9 @@ public sealed class HoleRecoveryPolicyCoverageMatrixTests
var exec = HoleRecoveryExecutor.Execute(plan);
if (plan.HoleKind == HoleKind.Stepped)
{
- Assert.Equal(HoleRecoveryExecutionStatus.UnsupportedPlan, exec.Status);
- Assert.Contains(exec.Diagnostics, d => d.Contains("stepped-execution-route-disabled-until-v13.3", StringComparison.Ordinal));
+ Assert.Equal(HoleRecoveryExecutionStatus.BooleanFailed, exec.Status);
+ Assert.Null(exec.Body);
+ Assert.Contains(exec.Diagnostics, d => d.Contains("repeated-subtract-small-medium-large", StringComparison.Ordinal));
return;
}
@@ -130,8 +131,9 @@ public sealed class HoleRecoveryPolicyCoverageMatrixTests
var exec = HoleRecoveryExecutor.Execute(plan);
if (plan.HoleKind == HoleKind.Stepped)
{
- Assert.Equal(HoleRecoveryExecutionStatus.UnsupportedPlan, exec.Status);
- Assert.Contains(exec.Diagnostics, d => d.Contains("stepped-execution-route-disabled-until-v13.3", StringComparison.Ordinal));
+ Assert.Equal(HoleRecoveryExecutionStatus.BooleanFailed, exec.Status);
+ Assert.Null(exec.Body);
+ Assert.Contains(exec.Diagnostics, d => d.Contains("repeated-subtract-small-medium-large", StringComparison.Ordinal));
return;
}
diff --git a/Aetheris.Kernel.Firmament.Tests/SteppedHolePlacementSemanticsTests.cs b/Aetheris.Kernel.Firmament.Tests/SteppedHolePlacementSemanticsTests.cs
index aab47761..3106d677 100644
--- a/Aetheris.Kernel.Firmament.Tests/SteppedHolePlacementSemanticsTests.cs
+++ b/Aetheris.Kernel.Firmament.Tests/SteppedHolePlacementSemanticsTests.cs
@@ -58,16 +58,16 @@ public sealed class SteppedHolePlacementSemanticsTests
{
var exec = HoleRecoveryExecutor.Execute(BuildPlan());
Assert.DoesNotContain(exec.Diagnostics, d => d.Contains("missing-stepped-entry-side-polarity", StringComparison.Ordinal));
- Assert.Contains(exec.Diagnostics, d => d.Contains("stepped-execution-route-disabled-until-v13.3", StringComparison.Ordinal));
+ Assert.Contains(exec.Diagnostics, d => d.Contains("no-hidden-placement-inference", StringComparison.Ordinal));
}
[Fact]
- public void SteppedExecution_RemainsDeferredInV13_2()
+ public void SteppedExecution_UsesExplicitPlacementRouteInV13_3()
{
var exec = HoleRecoveryExecutor.Execute(BuildPlan());
- Assert.Equal(HoleRecoveryExecutionStatus.UnsupportedPlan, exec.Status);
- Assert.Null(exec.Body);
- Assert.DoesNotContain(exec.Diagnostics, d => d.Contains("subtract", StringComparison.OrdinalIgnoreCase));
+ Assert.Equal(HoleRecoveryExecutionStatus.Succeeded, exec.Status);
+ Assert.NotNull(exec.Body);
+ Assert.Contains(exec.Diagnostics, d => d.Contains("Stepped executor route: repeated-subtract-small-medium-large", StringComparison.Ordinal));
Assert.Contains(exec.Diagnostics, d => d.Contains("No STEP export attempted", StringComparison.Ordinal));
}
diff --git a/Aetheris.Kernel.Firmament.Tests/SteppedHoleVariantAndExecutorTests.cs b/Aetheris.Kernel.Firmament.Tests/SteppedHoleVariantAndExecutorTests.cs
index 615b2340..409d4327 100644
--- a/Aetheris.Kernel.Firmament.Tests/SteppedHoleVariantAndExecutorTests.cs
+++ b/Aetheris.Kernel.Firmament.Tests/SteppedHoleVariantAndExecutorTests.cs
@@ -25,9 +25,11 @@ public sealed class SteppedHoleVariantAndExecutorTests
{
var plan = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(BuildStepped())).Plan!;
var exec = HoleRecoveryExecutor.Execute(plan);
- Assert.Equal(HoleRecoveryExecutionStatus.UnsupportedPlan, exec.Status);
+ Assert.Equal(HoleRecoveryExecutionStatus.BooleanFailed, exec.Status);
Assert.Null(exec.Body);
- Assert.Contains(exec.Diagnostics, d => d.Contains("stepped-execution-route-disabled-until-v13.3", StringComparison.Ordinal));
+ Assert.Contains(exec.Diagnostics, d => d.Contains("no-hidden-placement-inference", StringComparison.Ordinal));
+ Assert.Contains(exec.Diagnostics, d => d.Contains("Stepped subtract small succeeded", StringComparison.Ordinal));
+ Assert.Contains(exec.Diagnostics, d => d.Contains("Stepped subtract medium", StringComparison.Ordinal));
}
[Fact]
@@ -35,10 +37,7 @@ public sealed class SteppedHoleVariantAndExecutorTests
{
var plan = (HoleRecoveryPlan)new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(BuildStepped())).Plan!;
var exec = HoleRecoveryExecutor.Execute(plan);
- Assert.Equal(HoleRecoveryExecutionStatus.UnsupportedPlan, exec.Status);
- Assert.Null(exec.Body);
- Assert.Contains(exec.Diagnostics, d => d.Contains("stepped-execution-route-disabled-until-v13.3", StringComparison.Ordinal));
- Assert.Contains(exec.Diagnostics, d => d.Contains("No STEP export attempted", StringComparison.Ordinal));
+ Assert.Contains(exec.Diagnostics, d => d.Contains("Stepped executor route: repeated-subtract-small-medium-large", StringComparison.Ordinal));
}
[Fact]
@@ -72,7 +71,23 @@ public sealed class SteppedHoleVariantAndExecutorTests
var exec = HoleRecoveryExecutor.Execute(invalid);
Assert.Equal(HoleRecoveryExecutionStatus.UnsupportedPlan, exec.Status);
Assert.Null(exec.Body);
- Assert.Contains(exec.Diagnostics, d => d.Contains("stepped-execution-route-disabled-until-v13.3", StringComparison.Ordinal));
+ Assert.Contains(exec.Diagnostics, d => d.Contains("rejected before Boolean", StringComparison.Ordinal));
+ Assert.DoesNotContain(exec.Diagnostics, d => d.Contains("Stepped subtract", StringComparison.Ordinal));
+ }
+
+ [Fact]
+ public void SteppedHole_InvalidPlacement_RejectsBeforeBoolean()
+ {
+ var eval = new HoleRecoveryPolicy().Evaluate(new FrepMaterializerContext(BuildStepped()));
+ var plan = Assert.IsType<HoleRecoveryPlan>(eval.Plan);
+ var large = plan.ProfileStack[0] with { AnchorSide = HoleTierAnchorSide.Unknown };
+ var medium = plan.ProfileStack[1] with { IsThrough = true };
+ var small = plan.ProfileStack[2] with { IsThrough = false, ZMin = double.NaN };
+ var invalid = plan with { ProfileStack = [large, medium, small] };
+ var exec = HoleRecoveryExecutor.Execute(invalid);
+ Assert.Equal(HoleRecoveryExecutionStatus.UnsupportedPlan, exec.Status);
+ Assert.Null(exec.Body);
+ Assert.Contains(exec.Diagnostics, d => d.Contains("rejected before Boolean", StringComparison.Ordinal));
Assert.DoesNotContain(exec.Diagnostics, d => d.Contains("Stepped subtract", StringComparison.Ordinal));
}
diff --git a/Aetheris.Kernel.Firmament/Materializer/HoleRecoveryExecutor.cs b/Aetheris.Kernel.Firmament/Materializer/HoleRecoveryExecutor.cs
index b8e4f376..04b30e35 100644
--- a/Aetheris.Kernel.Firmament/Materializer/HoleRecoveryExecutor.cs
+++ b/Aetheris.Kernel.Firmament/Materializer/HoleRecoveryExecutor.cs
@@ -62,9 +62,8 @@ public static class HoleRecoveryExecutor
if (plan.HoleKind == HoleKind.Stepped && plan.DepthKind == HoleDepthKind.ThroughWithEntryRelief)
{
- diagnostics.Add("Stepped-hole plan recognized with explicit tier placement metadata; execution intentionally deferred in V13.2 pending production route re-enable.");
- diagnostics.Add("Deferred reason: stepped-execution-route-disabled-until-v13.3.");
- return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
+ diagnostics.Add("Stepped-hole plan recognized; stepped execution started.");
+ return ExecuteStepped(plan, diagnostics);
}
if (plan.HoleKind != HoleKind.Counterbore || plan.DepthKind != HoleDepthKind.ThroughWithEntryRelief)
@@ -163,6 +162,7 @@ public static class HoleRecoveryExecutor
private static HoleRecoveryExecutionResult ExecuteStepped(HoleRecoveryPlan plan, List<string> diagnostics)
{
+ diagnostics.Add("Stepped explicit-placement validation started.");
if (plan.HostKind != HoleHostKind.RectangularBox || plan.Axis != HoleAxisKind.Z || plan.ProfileStack.Count != 3)
{
diagnostics.Add("Stepped plan rejected before Boolean: host must be rectangular box, axis must be Z, and profile stack count must be exactly 3.");
@@ -193,8 +193,53 @@ public static class HoleRecoveryExecutor
return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
}
- diagnostics.Add("Stepped plan shape validated.");
- diagnostics.Add("Stepped repeated-subtract route selected: small-through -> medium-depth -> large-shallow.");
+ foreach (var segment in plan.ProfileStack)
+ {
+ if (segment.AnchorSide == HoleTierAnchorSide.Unknown)
+ {
+ diagnostics.Add("Stepped plan rejected before Boolean: anchor side cannot be Unknown.");
+ return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
+ }
+
+ if (double.IsNaN(segment.ZMin) || double.IsNaN(segment.ZMax) || segment.ZMax - segment.ZMin <= tolerance)
+ {
+ diagnostics.Add("Stepped plan rejected before Boolean: every tier must provide a valid explicit z-span.");
+ return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
+ }
+ }
+
+ if (!small.IsThrough || small.AnchorSide != HoleTierAnchorSide.Through)
+ {
+ diagnostics.Add("Stepped plan rejected before Boolean: small tier must explicitly be through with through anchor.");
+ return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
+ }
+
+ if (medium.IsThrough || large.IsThrough)
+ {
+ diagnostics.Add("Stepped plan rejected before Boolean: medium/large tiers must be blind tiers (IsThrough=false).");
+ return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
+ }
+
+ if (medium.AnchorSide != large.AnchorSide || (medium.AnchorSide != HoleTierAnchorSide.Top && medium.AnchorSide != HoleTierAnchorSide.Bottom))
+ {
+ diagnostics.Add("Stepped plan rejected before Boolean: medium and large blind tiers must share a concrete entry anchor side.");
+ return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
+ }
+
+ var hostMinZ = plan.HostTranslation.Z - (plan.HostSizeZ * 0.5d);
+ var hostMaxZ = plan.HostTranslation.Z + (plan.HostSizeZ * 0.5d);
+ if (small.ZMin > hostMinZ + tolerance || small.ZMax < hostMaxZ - tolerance)
+ {
+ diagnostics.Add("Stepped plan rejected before Boolean: through tier explicit z-span must cover host z-range.");
+ return new(HoleRecoveryExecutionStatus.UnsupportedPlan, null, diagnostics);
+ }
+
+ diagnostics.Add("Stepped explicit-placement validation succeeded.");
+ diagnostics.Add("Stepped executor marker: no-hidden-placement-inference; explicit z-span authority.");
+ diagnostics.Add($"Stepped segment placement: large radius={large.RadiusStart:0.###} zMin={large.ZMin:0.###} zMax={large.ZMax:0.###} anchor={large.AnchorSide} through={large.IsThrough}.");
+ diagnostics.Add($"Stepped segment placement: medium radius={medium.RadiusStart:0.###} zMin={medium.ZMin:0.###} zMax={medium.ZMax:0.###} anchor={medium.AnchorSide} through={medium.IsThrough}.");
+ diagnostics.Add($"Stepped segment placement: small radius={small.RadiusStart:0.###} zMin={small.ZMin:0.###} zMax={small.ZMax:0.###} anchor={small.AnchorSide} through={small.IsThrough}.");
+ diagnostics.Add("Stepped executor route: repeated-subtract-small-medium-large.");
var box = BrepPrimitives.CreateBox(plan.HostSizeX, plan.HostSizeY, plan.HostSizeZ);
if (!box.IsSuccess)
{
@@ -203,8 +248,9 @@ public static class HoleRecoveryExecutor
}
var body = TranslateBody(box.Value, plan.HostTranslation);
- var throughHeight = double.Max(plan.ThroughLength, plan.HostSizeZ);
- var smallResult = BrepPrimitives.CreateCylinder(small.RadiusStart, throughHeight);
+ var smallHeight = small.ZMax - small.ZMin;
+ var smallCenterZ = (small.ZMin + small.ZMax) * 0.5d;
+ var smallResult = BrepPrimitives.CreateCylinder(small.RadiusStart, smallHeight);
if (!smallResult.IsSuccess)
{
diagnostics.Add("Stepped small-through cylinder primitive construction failed.");
@@ -212,19 +258,17 @@ public static class HoleRecoveryExecutor
}
diagnostics.Add("Stepped subtract small invoked.");
- var smallSubtract = BrepBoolean.Subtract(body, TranslateBody(smallResult.Value, plan.ToolTranslation));
+ var smallSubtract = BrepBoolean.Subtract(body, TranslateBody(smallResult.Value, new Vector3D(plan.ToolTranslation.X, plan.ToolTranslation.Y, smallCenterZ)));
if (!smallSubtract.IsSuccess || smallSubtract.Value is null)
{
- diagnostics.Add("Stepped subtract small failed.");
+ diagnostics.Add($"Stepped subtract small failed: codes={string.Join(",", smallSubtract.Diagnostics.Select(d => d.Code))}.");
return new(HoleRecoveryExecutionStatus.BooleanFailed, null, diagnostics);
}
diagnostics.Add("Stepped subtract small succeeded.");
- var entryFaceZ = plan.HostTranslation.Z + (plan.HostSizeZ * 0.5d);
- diagnostics.Add($"Stepped entry face resolved to top(+Z) at z={entryFaceZ:0.###}.");
- diagnostics.Add($"Stepped route geometry: box=({plan.HostSizeX:0.###},{plan.HostSizeY:0.###},{plan.HostSizeZ:0.###})@({plan.HostTranslation.X:0.###},{plan.HostTranslation.Y:0.###},{plan.HostTranslation.Z:0.###}); small(r={small.RadiusStart:0.###},h={throughHeight:0.###},z=[{(plan.ToolTranslation.Z - (throughHeight * 0.5d)):0.###},{(plan.ToolTranslation.Z + (throughHeight * 0.5d)):0.###}]); medium(r={medium.RadiusStart:0.###},h={mediumDepth:0.###}); large(r={large.RadiusStart:0.###},h={largeDepth:0.###}).");
- var mediumCenter = new Vector3D(plan.ToolTranslation.X, plan.ToolTranslation.Y, entryFaceZ + (mediumDepth * 0.5d));
- var mediumResult = BrepPrimitives.CreateCylinder(medium.RadiusStart, mediumDepth);
+ var mediumHeight = medium.ZMax - medium.ZMin;
+ var mediumCenter = new Vector3D(plan.ToolTranslation.X, plan.ToolTranslation.Y, (medium.ZMin + medium.ZMax) * 0.5d);
+ var mediumResult = BrepPrimitives.CreateCylinder(medium.RadiusStart, mediumHeight);
if (!mediumResult.IsSuccess)
{
diagnostics.Add("Stepped medium-depth cylinder primitive construction failed.");
@@ -235,13 +279,14 @@ public static class HoleRecoveryExecutor
var mediumSubtract = BrepBoolean.Subtract(smallSubtract.Value, TranslateBody(mediumResult.Value, mediumCenter));
if (!mediumSubtract.IsSuccess || mediumSubtract.Value is null)
{
- diagnostics.Add($"Stepped subtract medium failed at center=({mediumCenter.X:0.###},{mediumCenter.Y:0.###},{mediumCenter.Z:0.###}) z=[{(mediumCenter.Z - (mediumDepth * 0.5d)):0.###},{(mediumCenter.Z + (mediumDepth * 0.5d)):0.###}].");
+ diagnostics.Add($"Stepped subtract medium failed: codes={string.Join(",", mediumSubtract.Diagnostics.Select(d => d.Code))}.");
return new(HoleRecoveryExecutionStatus.BooleanFailed, null, diagnostics);
}
diagnostics.Add("Stepped subtract medium succeeded.");
- var largeCenter = new Vector3D(plan.ToolTranslation.X, plan.ToolTranslation.Y, entryFaceZ + (largeDepth * 0.5d));
- var largeResult = BrepPrimitives.CreateCylinder(large.RadiusStart, largeDepth);
+ var largeHeight = large.ZMax - large.ZMin;
+ var largeCenter = new Vector3D(plan.ToolTranslation.X, plan.ToolTranslation.Y, (large.ZMin + large.ZMax) * 0.5d);
+ var largeResult = BrepPrimitives.CreateCylinder(large.RadiusStart, largeHeight);
if (!largeResult.IsSuccess)
{
diagnostics.Add("Stepped large-shallow cylinder primitive construction failed.");
@@ -252,7 +297,7 @@ public static class HoleRecoveryExecutor
var largeSubtract = BrepBoolean.Subtract(mediumSubtract.Value, TranslateBody(largeResult.Value, largeCenter));
if (!largeSubtract.IsSuccess || largeSubtract.Value is null)
{
- diagnostics.Add($"Stepped subtract large failed at center=({largeCenter.X:0.###},{largeCenter.Y:0.###},{largeCenter.Z:0.###}) z=[{(largeCenter.Z - (largeDepth * 0.5d)):0.###},{(largeCenter.Z + (largeDepth * 0.5d)):0.###}].");
+ diagnostics.Add($"Stepped subtract large failed: codes={string.Join(",", largeSubtract.Diagnostics.Select(d => d.Code))}.");
return new(HoleRecoveryExecutionStatus.BooleanFailed, null, diagnostics);
}
diff --git a/docs/brep-boolean-stack-a4-stepped-repeated-subtract-productionization.md b/docs/brep-boolean-stack-a4-stepped-repeated-subtract-productionization.md
index 31d974c9..bc18c4c6 100644
--- a/docs/brep-boolean-stack-a4-stepped-repeated-subtract-productionization.md
+++ b/docs/brep-boolean-stack-a4-stepped-repeated-subtract-productionization.md
@@ -1,56 +1,20 @@
-# BREP-BOOLEAN-STACK-A4: stepped repeated-subtract productionization
-
-## Outcome
-Success: bounded stepped-hole recovery is now executable in production for the canonical three-level coaxial stepped shape.
-
-## A3.1 evidence used
-A3.1 architecture-lab evidence showed repeated subtract orders are viable for canonical bounded stepped stacks, while unioned-tool and generic profile-stack routes remained deferred. A4 promotes only the bounded repeated-subtract route.
-
-## Production route enabled
-`HoleRecoveryExecutor` now executes stepped plans with deterministic order:
-1. small through subtract,
-2. medium depth blind subtract,
-3. large shallow blind subtract.
-
-The route is enabled only after bounded plan-shape validation:
-- `HoleKind.Stepped` + `HoleDepthKind.ThroughWithEntryRelief`,
-- host rectangular box,
-- Z axis,
-- exactly three cylindrical profile segments,
-- strict radius order `small < medium < large`,
-- strict depth order `large < medium < through`.
-
-Unsupported shape mismatch is rejected before boolean invocation with explicit diagnostics.
-
-## Diagnostics
-Stepped diagnostics now explicitly record:
-- executor start and no STEP export attempt,
-- stepped plan shape validation,
-- route selection (`small-through -> medium-depth -> large-shallow`),
-- per-stage subtract invocation and success/failure,
-- final body production.
-
-## STEP smoke and manifold policy
-Stepped STEP smoke now runs via executor-produced body and existing `Step242Exporter.ExportBody(...)`. Expected manifold markers are asserted and `BREP_WITH_VOIDS` remains absent.
-
-## Non-goals preserved
-- No generic N-level stepped support.
-- No unioned-tool production route.
-- No direct N-level topology builder.
-- No STEP exporter behavior changes.
-- No public CLI/API expansion.
-
-## Remaining limits
-Support remains intentionally bounded to the canonical three-level coaxial Z-axis stepped-hole family.
-
-## A4.1 reconciliation update (lab vs production)
-- **Finding:** FrictionLab repeated-subtract success was demonstrated on a lab geometry route that is not semantically equivalent to the current production `HoleRecoveryPlan` contract.
-- FrictionLab route explicitly constructs medium/large tier Z placement in tool-building code (fixed signed translation), while production stepped plan only carries depth magnitudes and no explicit entry-side polarity for each relief tier.
-- Because `SteppedHoleVariant` currently admits both entry faces (`boxMinZ` and `boxMaxZ`) and does not encode which face was used, `HoleRecoveryExecutor` cannot safely reconstruct the exact lab route from plan data alone.
-- **Decision (Outcome B):** stepped execution is restored to **deferred** in production with explicit diagnostic:
- - `missing-stepped-entry-side-polarity`
-- Through/blind/counterbore/countersink execution paths remain unchanged.
-
-## V13.2 follow-up
-- V13.2 closes the prior plan-contract gap by adding explicit stepped tier placement semantics to `HoleProfileSegment` and populating anchor/depth/z-span metadata for each tier.
-- The old polarity-missing blocker is retired; stepped execution remains deferred under a new intentional gate (`stepped-execution-route-disabled-until-v13.3`) until production route re-enable.
+# BREP-BOOLEAN-STACK-A4: stepped repeated-subtract productionization (V13.3)
+
+## Inputs
+- A3.1 FrictionLab evidence: repeated-subtract variants succeed on canonical stepped case.
+- V13.2 contract fix: explicit stepped tier placement semantics on `HoleProfileSegment`.
+
+## V13.3 production result
+- Bounded stepped production execution re-enabled in `HoleRecoveryExecutor`.
+- Executor validates explicit placement before any Boolean.
+- Tools are built from explicit `ZMin/ZMax` only.
+- Route selected: `repeated-subtract-small-medium-large`.
+- Boolean stages are diagnostic-rich (`small`, `medium`, `large` stage invoke/success/failure markers).
+- STEP smoke remains exporter-neutral and verifies manifold solid/no-void markers.
+
+## Current bounds intentionally retained
+- No arbitrary N-level stepped support.
+- No unioned-tool route.
+- No direct topology builder.
+- No STEP exporter behavior change.
+- No public API/CLI expansion.
diff --git a/docs/cir-recovery-v13-stepped-hole-variant-executor-step.md b/docs/cir-recovery-v13-stepped-hole-variant-executor-step.md
index 2ffb756b..d6be907c 100644
--- a/docs/cir-recovery-v13-stepped-hole-variant-executor-step.md
+++ b/docs/cir-recovery-v13-stepped-hole-variant-executor-step.md
@@ -44,3 +44,13 @@ Introduce a dedicated stepped-tool execution architecture before enabling steppe
1. bounded stepped tool builder + validated single subtract,
2. unioned coaxial tool composition with dedicated Boolean stability contracts,
3. dedicated profile-stack executor/topology builder for stepped coaxial reliefs.
+
+## V13.3 execution restoration update
+Production stepped execution is restored for the bounded canonical shape (three cylindrical tiers, one through + two blind entry tiers, rectangular host, Z-axis).
+
+Execution now consumes explicit V13.2 placement semantics directly:
+- per-tier `ZMin/ZMax` drive tool height and center placement,
+- no hidden depth/anchor reconstruction in executor,
+- repeated subtract route is fixed to `small -> medium -> large`.
+
+STEP smoke is restored in tests using existing `Step242Exporter.ExportBody(...)`, asserting `ISO-10303-21`, `MANIFOLD_SOLID_BREP`, `ADVANCED_FACE`, `CYLINDRICAL_SURFACE`, and asserting absence of `BREP_WITH_VOIDS`.
diff --git a/docs/cir-recovery-v132-stepped-tier-placement-semantics.md b/docs/cir-recovery-v132-stepped-tier-placement-semantics.md
index c0821943..a14fd73a 100644
--- a/docs/cir-recovery-v132-stepped-tier-placement-semantics.md
+++ b/docs/cir-recovery-v132-stepped-tier-placement-semantics.md
@@ -41,3 +41,12 @@ No stepped Boolean execution is attempted in this milestone.
## V13.3 next step
Re-enable stepped production execution using plan-provided placement semantics (`AnchorSide`, `DepthFromAnchor`, `ZMin/ZMax`, `IsThrough`) and keep route-equivalence tests as an execution gate.
+
+## V13.3 execution consumption update
+V13.3 re-enables bounded stepped execution and now treats these placement fields as executable source-of-truth:
+- executor validates explicit `AnchorSide`, `IsThrough`, and concrete `ZMin/ZMax` for every tier,
+- through tier must explicitly declare `AnchorSide=Through` and `IsThrough=true`,
+- medium/large tiers must be blind and share one concrete entry anchor side,
+- tool construction uses `height = ZMax - ZMin` and `centerZ = (ZMin + ZMax)/2` with no hidden span inference.
+
+Route is explicitly `repeated-subtract-small-medium-large`; any placement inconsistency rejects before Boolean.