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.csindex c6cc3ed4..8a2a70dd 100644--- a/Aetheris.Kernel.Firmament.Tests/FrepSemanticRecoveryRematerializerTests.cs+++ b/Aetheris.Kernel.Firmament.Tests/FrepSemanticRecoveryRematerializerTests.cs@@ -82,7 +82,6 @@ public sealed class FrepSemanticRecoveryRematerializerTestsAssert.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.csindex 4feacee1..9739f425 100644--- a/Aetheris.Kernel.Firmament.Tests/HoleRecoveryPolicyCoverageMatrixTests.cs+++ b/Aetheris.Kernel.Firmament.Tests/HoleRecoveryPolicyCoverageMatrixTests.cs@@ -107,8 +107,9 @@ public sealed class HoleRecoveryPolicyCoverageMatrixTestsvar 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 HoleRecoveryPolicyCoverageMatrixTestsvar 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.csindex 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.csindex 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 SteppedHoleVariantAndExecutorTestsvar 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.csindex b8e4f376..04b30e35 100644--- a/Aetheris.Kernel.Firmament/Materializer/HoleRecoveryExecutor.cs+++ b/Aetheris.Kernel.Firmament/Materializer/HoleRecoveryExecutor.cs@@ -62,9 +62,8 @@ public static class HoleRecoveryExecutorif (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 HoleRecoveryExecutorprivate 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 HoleRecoveryExecutorreturn 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 HoleRecoveryExecutorvar 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 HoleRecoveryExecutorvar 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.mdindex 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.mdindex 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 steppe1. 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.mdindex 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 stepRe-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.