Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Add controlled side-hole exit loop evidence

Yuechen Lif98539ef61b4
diff --git a/Aetheris.CLI.Tests/AirTraceCommandTests.cs b/Aetheris.CLI.Tests/AirTraceCommandTests.cs
index b5866943..3fc42869 100644
--- a/Aetheris.CLI.Tests/AirTraceCommandTests.cs
+++ b/Aetheris.CLI.Tests/AirTraceCommandTests.cs
@@ -342,7 +342,7 @@ public sealed class AirTraceCommandTests
using var doc = JsonDocument.Parse(output); var root = doc.RootElement;
Assert.Equal("valid", root.GetProperty("fixture").GetProperty("expectation").GetString());
Assert.True(root.GetProperty("fixture").GetProperty("expectationSatisfied").GetBoolean());
- Assert.Equal("region-face-split", root.GetProperty("actualStageReached").GetString());
+ Assert.Equal("region-exit-loop", root.GetProperty("actualStageReached").GetString());
var regions = root.GetProperty("regions");
Assert.Equal(2, regions.GetProperty("regionCount").GetInt32());
Assert.True(regions.GetProperty("hasNestedRegions").GetBoolean());
@@ -504,7 +504,7 @@ public sealed class AirTraceCommandTests
Assert.Contains("Region face split", output);
Assert.Contains("Status: SplitCreated", output);
Assert.Contains("Entry loop: EntryLoopMaterialized", output);
- Assert.Contains("Category: ExitLoopInsertion", output);
+ Assert.Contains("Category: CutWallAttachment", output);
Assert.Contains("controlled fixture only", output);
}
@@ -520,8 +520,8 @@ public sealed class AirTraceCommandTests
Assert.Equal("ControlledSideHoleParentBRepIntegration", parent.GetProperty("route").GetString());
Assert.Contains(parent.GetProperty("placeholderMappings").EnumerateArray(), m => m.GetProperty("placeholderRole").GetString() == "CutEntryLoop" && m.GetProperty("materializationStatus").GetString() == "Materialized");
Assert.Contains(parent.GetProperty("placeholderMappings").EnumerateArray(), m => m.GetProperty("placeholderRole").GetString() == "CutWallFace" && m.GetProperty("materializationStatus").GetString() == "Materialized");
- Assert.Equal("ExitLoopInsertion", parent.GetProperty("blocker").GetProperty("category").GetString());
- Assert.Equal("controlled-side-hole-exit-loop-insertion-deferred", parent.GetProperty("blocker").GetProperty("code").GetString());
+ Assert.Equal("CutWallAttachment", parent.GetProperty("blocker").GetProperty("category").GetString());
+ Assert.Equal("controlled-side-hole-cut-wall-attachment-deferred", parent.GetProperty("blocker").GetProperty("code").GetString());
}
[Fact]
@@ -607,7 +607,7 @@ public sealed class AirTraceCommandTests
using var doc = JsonDocument.Parse(output);
var side = doc.RootElement.GetProperty("regions").GetProperty("regions").EnumerateArray().Single(r => r.GetProperty("regionKind").GetString() == "FaceAttachedRegion");
Assert.Equal("SplitCreated", side.GetProperty("faceSplit").GetProperty("faceSplitStatus").GetString());
- Assert.Equal("ExitLoopInsertion", side.GetProperty("parentIntegration").GetProperty("blocker").GetProperty("category").GetString());
+ Assert.Equal("CutWallAttachment", side.GetProperty("parentIntegration").GetProperty("blocker").GetProperty("category").GetString());
Assert.DoesNotContain("controlled-side-hole-parent-face-splitting-missing", output, StringComparison.Ordinal);
}
@@ -619,7 +619,7 @@ public sealed class AirTraceCommandTests
var side = doc.RootElement.GetProperty("regions").GetProperty("regions").EnumerateArray().Single(r => r.GetProperty("regionKind").GetString() == "FaceAttachedRegion");
var parent = side.GetProperty("parentIntegration");
Assert.Equal("PartiallyIntegrated", parent.GetProperty("status").GetString());
- Assert.Equal("ExitLoopInsertion", parent.GetProperty("blocker").GetProperty("category").GetString());
+ Assert.Equal("CutWallAttachment", parent.GetProperty("blocker").GetProperty("category").GetString());
Assert.Equal("deferred", parent.GetProperty("stepSmoke").GetProperty("status").GetString());
}
@@ -640,6 +640,78 @@ public sealed class AirTraceCommandTests
Assert.Equal(first, second);
}
+
+ [Fact]
+ public void TraceSideHoleRegion_ExitLoop_DefaultText()
+ {
+ var (exitCode, output, error) = Run("trace", "--fixture", RegionFixture("valid/side-hole-face-attached-region.valid.firmfixture"));
+ Assert.Equal(0, exitCode);
+ Assert.Equal(string.Empty, error);
+ Assert.Contains("Region exit loop", output);
+ Assert.Contains("Exit face: -X", output);
+ Assert.Contains("Status: ExitLoopMaterialized", output);
+ Assert.Contains("Profile: Circle(radius=1)", output);
+ Assert.Contains("Placeholder consumed: CutExitLoop", output);
+ }
+
+ [Fact]
+ public void TraceSideHoleRegion_ExitLoop_Json()
+ {
+ var (exitCode, output, _) = Run("trace", "--fixture", RegionFixture("valid/side-hole-face-attached-region.valid.firmfixture"), "--json");
+ Assert.Equal(0, exitCode);
+ using var doc = JsonDocument.Parse(output);
+ var side = doc.RootElement.GetProperty("regions").GetProperty("regions").EnumerateArray().Single(r => r.GetProperty("regionKind").GetString() == "FaceAttachedRegion");
+ var exitLoop = side.GetProperty("exitLoop");
+ Assert.Equal("-X", exitLoop.GetProperty("exitFaceSelector").GetString());
+ Assert.Equal("ExitLoopMaterialized", exitLoop.GetProperty("exitLoopStatus").GetString());
+ Assert.Equal(1, exitLoop.GetProperty("exitLoopRadius").GetDouble());
+ Assert.Contains("region:side-hole:+x:exit-loop", exitLoop.GetProperty("materializedPlaceholderIds").EnumerateArray().Select(x => x.GetString()));
+ Assert.Equal(JsonValueKind.Null, exitLoop.GetProperty("blocker").ValueKind);
+ }
+
+ [Fact]
+ public void TraceSideHoleRegion_ExitLoop_AdvancesOrRefinesX9Blocker()
+ {
+ var output = Run("trace", "--fixture", RegionFixture("valid/side-hole-face-attached-region.valid.firmfixture"), "--json").Stdout;
+ using var doc = JsonDocument.Parse(output);
+ var side = doc.RootElement.GetProperty("regions").GetProperty("regions").EnumerateArray().Single(r => r.GetProperty("regionKind").GetString() == "FaceAttachedRegion");
+ Assert.Equal("ExitLoopMaterialized", side.GetProperty("exitLoop").GetProperty("exitLoopStatus").GetString());
+ Assert.Equal("CutWallAttachment", side.GetProperty("parentIntegration").GetProperty("blocker").GetProperty("category").GetString());
+ Assert.DoesNotContain("controlled-side-hole-exit-loop-insertion-deferred", output, StringComparison.Ordinal);
+ }
+
+ [Fact]
+ public void TraceSideHoleRegion_EntryLoopEvidencePreserved()
+ {
+ var output = Run("trace", "--fixture", RegionFixture("valid/side-hole-face-attached-region.valid.firmfixture"), "--json").Stdout;
+ using var doc = JsonDocument.Parse(output);
+ var side = doc.RootElement.GetProperty("regions").GetProperty("regions").EnumerateArray().Single(r => r.GetProperty("regionKind").GetString() == "FaceAttachedRegion");
+ Assert.Equal("EntryLoopMaterialized", side.GetProperty("faceSplit").GetProperty("entryLoopStatus").GetString());
+ Assert.Contains("region:side-hole:+x:entry-loop", side.GetProperty("faceSplit").GetProperty("materializedPlaceholderIds").EnumerateArray().Select(x => x.GetString()));
+ Assert.Contains(side.GetProperty("parentIntegration").GetProperty("placeholderMappings").EnumerateArray(), m => m.GetProperty("placeholderRole").GetString() == "CutEntryLoop" && m.GetProperty("materializationStatus").GetString() == "Materialized");
+ }
+
+ [Fact]
+ public void TraceSideHoleRegion_DoesNotClaimFullIntegrationPrematurely()
+ {
+ var output = Run("trace", "--fixture", RegionFixture("valid/side-hole-face-attached-region.valid.firmfixture"), "--json").Stdout;
+ using var doc = JsonDocument.Parse(output);
+ var side = doc.RootElement.GetProperty("regions").GetProperty("regions").EnumerateArray().Single(r => r.GetProperty("regionKind").GetString() == "FaceAttachedRegion");
+ var parent = side.GetProperty("parentIntegration");
+ Assert.Equal("PartiallyIntegrated", parent.GetProperty("status").GetString());
+ Assert.Equal("CutWallAttachment", parent.GetProperty("blocker").GetProperty("category").GetString());
+ Assert.Equal("deferred", parent.GetProperty("stepSmoke").GetProperty("status").GetString());
+ Assert.False(parent.GetProperty("topologySummary").GetProperty("closed").GetBoolean());
+ }
+
+ [Fact]
+ public void ExitLoop_IsDeterministic()
+ {
+ var first = Run("trace", "--fixture", RegionFixture("valid/side-hole-face-attached-region.valid.firmfixture"), "--json").Stdout;
+ var second = Run("trace", "--fixture", RegionFixture("valid/side-hole-face-attached-region.valid.firmfixture"), "--json").Stdout;
+ Assert.Equal(first, second);
+ }
+
[Fact]
public void TraceImplicitParentMutationRegion_RejectedWithYieldContractReason()
{
diff --git a/Aetheris.CLI/AirTrace.cs b/Aetheris.CLI/AirTrace.cs
index b1eb2342..b84c5d68 100644
--- a/Aetheris.CLI/AirTrace.cs
+++ b/Aetheris.CLI/AirTrace.cs
@@ -192,18 +192,18 @@ internal static class AirTraceReportBuilder
private static AirTraceReport BuildSideHoleFaceAttachedRegionFixture(FirmFixture fixture)
{
var regions = AirRegionTraceFactory.ForFaceAttachedSideHoleDeferred();
- var actualStage = "region-face-split";
+ var actualStage = "region-exit-loop";
var expectationSatisfied = fixture.Expectation == "valid" && (string.IsNullOrWhiteSpace(fixture.ExpectedStage) || fixture.ExpectedStage == actualStage);
var fxDiagnostics = Stable([.. fixture.Diagnostics, .. regions.Diagnostics, "air-region-x1-firmfixture-case-mapped", "air-region-x4-firmfixture-boundary-contract-created", "air-region-x5-firmfixture-integration-decision-created", "air-region-x6-firmfixture-brep-placeholders-created", "air-region-x7-firmfixture-materialization-created", expectationSatisfied ? "air-region-x1-expectation-satisfied" : "air-region-x1-expectation-not-satisfied"]).ToArray();
- return new("AIR-REGION-X9", "trace", "lowering", "firmfixture", fixture.CaseName, expectationSatisfied, "FaceAttachedRegion side-hole creates controlled +X parent face split and entry-loop evidence; parent integration remains partial.",
- new("RegionFixture", "ControlledSideHoleParentBRepIntegration", "none", "none", "metadata-driven-region-contract", fixture.CaseName, fixture.CaseName, "AIR-REGION-X9"),
- new("SwitchMatch", "ControlledSideHoleParentBRepIntegration", false, "controlled +X face split and entry loop evidence created; parent integration remains partial", "FaceAttachedRegion", "SideHole", []),
+ return new("AIR-REGION-X10", "trace", "lowering", "firmfixture", fixture.CaseName, expectationSatisfied, "FaceAttachedRegion side-hole creates controlled +X entry-loop and -X exit-loop evidence; parent integration remains partial.",
+ new("RegionFixture", "ControlledSideHoleParentBRepIntegration", "none", "none", "metadata-driven-region-contract", fixture.CaseName, fixture.CaseName, "AIR-REGION-X10"),
+ new("SwitchMatch", "ControlledSideHoleParentBRepIntegration", false, "controlled +X entry loop and -X exit loop evidence created; parent integration remains partial", "FaceAttachedRegion", "SideHole", []),
new("none", 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, "none", "none", null, []),
- new("ControlledSideHoleParentBRepIntegration", true, "standalone side-hole patch evidence preserved; controlled +X entry face split evidence created; parent integration partial"),
+ new("ControlledSideHoleParentBRepIntegration", true, "standalone side-hole patch evidence preserved; controlled +X entry and -X exit face split evidence created; parent integration partial"),
new(false, false, false, false, []),
new("not-requested", "none", "none", "RegionFixture", "none", "none", "none", [], [], [], []),
[], ["parent BRep integration not implemented", "CIR evaluator composition deferred"], fxDiagnostics,
- [.. regions.Guarantees, "metadata-driven region fixture", "controlled standalone patch materialized", "controlled +X face split evidence", "parent integration partial"],
+ [.. regions.Guarantees, "metadata-driven region fixture", "controlled standalone patch materialized", "controlled +X face split evidence", "controlled -X exit loop evidence", "parent integration partial"],
["no AIR Region production integration", "no production route replacement", "no Firmament grammar expansion", "no BRepPlan semantics change", "no CIR evaluator/tape behavior change", "no STEP exporter/importer change", "no BRep topology behavior change", "no route-selection/JudgmentUtility behavior change", "no production analyzer behavior change", "no Boolean behavior change", "no AirEdgeSweep behavior change", "no BrepBoundedChamfer/BrepBoundedFillet behavior change", "no chamfer/fillet/shell geometry change", "no arbitrary graph support", "no import/recovery", "no triangle migration", "no NURBS/freeform behavior change"],
new(fixture.Path, fixture.Expectation, fixture.CaseName, fixture.ExpectedStage, actualStage!, fixture.ExpectedRoute, fixture.ExpectedReason, expectationSatisfied, false, fxDiagnostics),
fixture.Path, fixture.Expectation, fixture.CaseName, fixture.ExpectedStage, actualStage!, fixture.ExpectedRoute, fixture.ExpectedReason, expectationSatisfied, fxDiagnostics, Regions: regions);
@@ -434,6 +434,36 @@ internal static class AirTraceTextRenderer
foreach (var guarantee in fs.Guarantees) b.AppendLine($" - {guarantee}");
}
+ if (region.ExitLoop is not null)
+ {
+ var el = region.ExitLoop;
+ b.AppendLine(" Region exit loop");
+ b.AppendLine($" Region: {el.SourceRegionId}");
+ b.AppendLine($" Exit face: {el.ExitFaceSelector}");
+ b.AppendLine($" Status: {el.ExitLoopStatus}");
+ b.AppendLine($" Profile: {el.ExitLoopProfile}");
+ b.AppendLine($" Placeholder consumed: {el.ExitLoopRole}");
+ b.AppendLine(" Topology:");
+ b.AppendLine($" Face loops: {el.TopologySummary.FaceLoopCount}");
+ b.AppendLine($" Inner loops: {el.TopologySummary.InnerLoopCount}");
+ b.AppendLine($" Circular edges: {el.TopologySummary.CircularEdgeCount}");
+ b.AppendLine(" Blocker:");
+ if (el.Blocker is null)
+ {
+ b.AppendLine(" Category: none");
+ b.AppendLine(" Code: none");
+ b.AppendLine(" Message: none");
+ }
+ else
+ {
+ b.AppendLine($" Category: {el.Blocker.Category}");
+ b.AppendLine($" Code: {el.Blocker.Code}");
+ b.AppendLine($" Message: {el.Blocker.Message}");
+ }
+ b.AppendLine(" Guarantees:");
+ foreach (var guarantee in el.Guarantees) b.AppendLine($" - {guarantee}");
+ }
+
if (region.ParentIntegration is not null)
{
var pi = region.ParentIntegration;
diff --git a/Aetheris.Kernel.Core/Air/AirRegions.cs b/Aetheris.Kernel.Core/Air/AirRegions.cs
index e524cd8b..5fd0397f 100644
--- a/Aetheris.Kernel.Core/Air/AirRegions.cs
+++ b/Aetheris.Kernel.Core/Air/AirRegions.cs
@@ -15,6 +15,8 @@ internal enum AirRegionBRepPlaceholderStatus { PlaceholderOnly, NotMaterialized,
internal enum AirRegionMaterializationStatus { Materialized, PartiallyMaterialized, Deferred, Rejected, Unsupported }
internal enum AirRegionIntegrationBlockerCategory { MissingBRepApi, FaceSplitting, LoopInsertion, ExitLoopInsertion, CutWallAttachment, CylindricalWallBinding, ShellClosure, STEPExport, ParentIntegrationPatch, UnsafeBooleanBackend, FrameMismatch, TopologyValidation, Unknown }
internal enum AirRegionFaceSplitStatus { SplitCreated, EntryLoopMaterialized, PartiallySplit, Blocked, Deferred, Rejected, Unsupported }
+internal enum AirRegionExitLoopStatus { ExitLoopMaterialized, ExitFaceSplitCreated, PartiallyIntegrated, Blocked, Deferred, Rejected, Unsupported }
+internal enum AirRegionExitLoopBlockerCategory { OppositeFaceSelection, ExitFaceSplit, CircularLoopBinding, LoopOrientation, CoedgeConstruction, FaceTrim, TopologyValidation, StepFaceWithHoleExport, Unknown }
@@ -47,6 +49,8 @@ internal sealed record AirRegionParentIntegrationSummary(string SourceRegionId,
internal sealed record AirRegionFaceSplitTopologySummary(bool ParentFaceEvidenceExists, int FaceLoopCount, int InnerLoopCount, int CircularEdgeCount, string Bounds, IReadOnlyList<string> EvidenceRoles);
internal sealed record AirRegionFaceSplitBlocker(AirRegionIntegrationBlockerCategory Category, string Code, string Message, IReadOnlyList<string> Diagnostics);
internal sealed record AirRegionFaceSplitSummary(string SourceRegionId, string AffectedFaceSelector, AirRegionFaceSplitStatus FaceSplitStatus, AirRegionFaceSplitStatus EntryLoopStatus, string EntryLoopRole, string EntryLoopProfile, double EntryLoopRadius, string EntryLoopFrame, string AffectedParentFaceRole, IReadOnlyList<string> MaterializedPlaceholderIds, AirRegionFaceSplitTopologySummary TopologySummary, AirRegionFaceSplitBlocker? Blocker, IReadOnlyList<string> Diagnostics, IReadOnlyList<string> Guarantees);
+internal sealed record AirRegionExitLoopBlocker(AirRegionExitLoopBlockerCategory Category, string Code, string Message, IReadOnlyList<string> Diagnostics);
+internal sealed record AirRegionExitLoopSummary(string SourceRegionId, string ExitFaceSelector, AirRegionExitLoopStatus ExitLoopStatus, string ExitLoopRole, string ExitLoopProfile, double ExitLoopRadius, string ExitLoopFrame, IReadOnlyList<string> MaterializedPlaceholderIds, AirRegionFaceSplitTopologySummary TopologySummary, AirRegionExitLoopBlocker? Blocker, IReadOnlyList<string> Diagnostics, IReadOnlyList<string> Guarantees);
internal sealed record AirRegionAffectedParentSummary(string ParentRegionId, string ParentBody, string AffectedFaceSelector, string AffectedFaceRole, string AffectedScope, string Locality);
internal sealed record AirRegionEntryBoundarySummary(string BoundaryKind, string ProfileKind, string ProfileSource, string LocalFrameId, string LoopIntent, string Role);
internal sealed record AirRegionExitBoundarySummary(string BoundaryKind, string ExitKind, string Role, string Status, IReadOnlyList<string> Diagnostics);
@@ -170,6 +174,7 @@ internal static class AirSideHolePlaceholderMaterializer
return new(region.RegionId, region.Yield.FeatureKind, AirRegionMaterializationStatus.PartiallyMaterialized, "ControlledSideHolePatchMaterialization", mappings, new(true, false, 1, 2, 1, "local-cylinder-patch:x=+5..-5,r=1", ["MaterializedEntryLoop", "MaterializedExitLoop", "CylindricalCutWallFace"]), new(false, false, ["air-region-x7-step-smoke-unavailable", "step smoke not checked because parent integration remains deferred"]), diagnostics, ["parent-brep-integration-not-implemented", "standalone-patch-only", "no-closed-parent-body"], ["controlled fixture only", "no general side-hole support", "no arbitrary face/axis support", "no production route replacement", "no parent topology mutation", "parent integration deferred", "CIR remains analysis-only", "Boolean not generally admitted", "no STEP exporter/importer change"]);
}
+
private static AirRegionBRepPlaceholderMaterialization Map(AirRegionBRepPlaceholderElement e, AirRegionMaterializationStatus status, string kind, string role, string? id, string diagnostic) => new(e.Id, e.Role, status, kind, role, id, [diagnostic]);
private static IEnumerable<string> Stable(IEnumerable<string> values) => values.Distinct(StringComparer.Ordinal).OrderBy(x => x, StringComparer.Ordinal);
}
@@ -184,21 +189,21 @@ internal static class AirSideHoleParentBRepIntegrationPrototype
{
Map(byRole["AffectedParentFace"], AirRegionMaterializationStatus.Materialized, "ParentFaceWithInnerLoopEvidence", "ControlledPlusXFaceSplitEvidence", "brep:root-box:face:+x:split-entry-loop", "air-region-x9-parent-face-split-created"),
Map(byRole["CutEntryLoop"], AirRegionMaterializationStatus.Materialized, "ParentInnerLoopEvidence", "MaterializedEntryLoop", "region:side-hole:+x:entry-loop", "air-region-x9-cut-entry-loop-placeholder-consumed"),
- Map(byRole["CutExitLoop"], AirRegionMaterializationStatus.Deferred, "ParentLoop", "RequiresOppositeFaceLoopInsertion", null, "air-region-x8-cut-exit-loop-blocked-by-face-splitting"),
+ Map(byRole["CutExitLoop"], AirRegionMaterializationStatus.Materialized, "ParentInnerLoopEvidence", "MaterializedExitLoop", "region:side-hole:+x:exit-loop", "air-region-x10-cut-exit-loop-placeholder-consumed"),
Map(byRole["CutWallFace"], AirRegionMaterializationStatus.Materialized, "CylindricalFaceEvidence", "StandaloneCylindricalCutWallEvidence", "brep:side-hole:+x:cut-wall-face", "air-region-x8-cut-wall-face-evidence-preserved"),
- Map(byRole["RegionIntegrationPatch"], AirRegionMaterializationStatus.Deferred, "ParentIntegrationPatch", "BlockedAfterEntryFaceSplit", null, "air-region-x9-parent-integration-still-partial")
+ Map(byRole["RegionIntegrationPatch"], AirRegionMaterializationStatus.Deferred, "ParentIntegrationPatch", "BlockedAfterEntryExitFaceSplits", null, "air-region-x10-parent-integration-still-partial")
};
var blocker = new AirRegionIntegrationBlocker(
- AirRegionIntegrationBlockerCategory.ExitLoopInsertion,
- "controlled-side-hole-exit-loop-insertion-deferred",
- "The controlled +X parent face split and circular entry loop evidence were created, but opposite-face exit loop insertion, cut-wall attachment, and parent shell closure remain deferred for a later controlled milestone.",
- "ExitLoopInsertionAndShellClosure",
- [byRole["CutExitLoop"].Id, byRole["CutWallFace"].Id, byRole["RegionIntegrationPatch"].Id],
- ["x2-yield-contract-present", "x3-cir-mirror-analysis-only", "x4-brep-boundary-contract-present", "x5-route-decision-present", "x6-placeholders-present", "x7-standalone-patch-materialized", "standalone-cylindrical-cut-wall-face-evidence-present"],
- "Add controlled opposite-face exit loop insertion, bind the preserved cylindrical cut-wall evidence to the split parent faces, and close the parent shell.",
- ["air-region-x9-face-splitting-blocker-cleared", "air-region-x9-exit-loop-insertion-deferred"]);
- var diagnostics = Stable(["air-region-x8-parent-integration-request-created", "air-region-x8-side-hole-parent-integration-started", "air-region-x8-placeholder-plan-consumed", "air-region-x8-x7-patch-evidence-consumed", "air-region-x8-controlled-parent-integration-route-selected", "air-region-x8-current-evidence-preserved", "air-region-x9-face-splitting-blocker-cleared", "air-region-x9-parent-integration-still-partial", "air-region-x9-no-fake-parent-integration", "air-region-x9-controlled-fixture-only", "air-region-x9-no-general-side-hole-support", "air-region-x9-no-production-route-replacement", "air-region-x9-cir-remains-analysis-only", .. mappings.SelectMany(m => m.Diagnostics), .. blocker.Diagnostics]).ToArray();
- return new(region.RegionId, region.Yield.FeatureKind, AirRegionIntegrationStatus.PartiallyIntegrated, AirRegionIntegrationRouteKind.ControlledSideHoleParentBRepIntegration, mappings, new(true, false, 6, 7, 1, "parent-box:10x8x6; +X face split with circular inner entry loop; x7 local patch bounds preserved", ["ControlledPlusXFaceSplitEvidence", "MaterializedEntryLoop", "StandaloneCylindricalCutWallFaceEvidence"]), new(false, false, "deferred", ["air-region-x9-step-smoke-deferred", "step smoke deferred because exit loop, cut-wall attachment, and shell closure remain incomplete"]), blocker, diagnostics, ["exit-loop-insertion-deferred", "cut-wall-attachment-deferred", "parent-shell-not-closed", "standalone-patch-preserved"], ["controlled fixture only", "controlled +X face entry loop evidence", "no general side-hole support", "no arbitrary face/axis support", "no production route replacement", "no parent topology mutation outside controlled prototype evidence", "CIR remains analysis-only", "Boolean not used", "Boolean not generally admitted", "no STEP exporter/importer change"]);
+ AirRegionIntegrationBlockerCategory.CutWallAttachment,
+ "controlled-side-hole-cut-wall-attachment-deferred",
+ "The controlled +X entry loop and opposite -X exit loop evidence were created, but cylindrical cut-wall attachment to both split parent faces and parent shell closure remain deferred for a later controlled milestone.",
+ "CutWallAttachmentAndShellClosure",
+ [byRole["CutWallFace"].Id, byRole["RegionIntegrationPatch"].Id],
+ ["x2-yield-contract-present", "x3-cir-mirror-analysis-only", "x4-brep-boundary-contract-present", "x5-route-decision-present", "x6-placeholders-present", "x7-standalone-patch-materialized", "x9-entry-loop-materialized", "x10-exit-loop-materialized", "standalone-cylindrical-cut-wall-face-evidence-present"],
+ "Bind the preserved cylindrical cut-wall evidence to the controlled +X entry and -X exit face loop evidence, then validate parent shell closure.",
+ ["air-region-x10-exit-loop-insertion-blocker-cleared", "air-region-x10-cut-wall-attachment-deferred"]);
+ var diagnostics = Stable(["air-region-x8-parent-integration-request-created", "air-region-x8-side-hole-parent-integration-started", "air-region-x8-placeholder-plan-consumed", "air-region-x8-x7-patch-evidence-consumed", "air-region-x8-controlled-parent-integration-route-selected", "air-region-x8-current-evidence-preserved", "air-region-x9-face-splitting-blocker-cleared", "air-region-x9-parent-integration-still-partial", "air-region-x9-no-fake-parent-integration", "air-region-x9-controlled-fixture-only", "air-region-x9-no-general-side-hole-support", "air-region-x9-no-production-route-replacement", "air-region-x9-cir-remains-analysis-only", "air-region-x10-opposite-face-selected", "air-region-x10-minus-x-exit-face-selected", "air-region-x10-exit-loop-insertion-blocker-cleared", "air-region-x10-parent-integration-still-partial", "air-region-x10-no-boolean", .. mappings.SelectMany(m => m.Diagnostics), .. blocker.Diagnostics]).ToArray();
+ return new(region.RegionId, region.Yield.FeatureKind, AirRegionIntegrationStatus.PartiallyIntegrated, AirRegionIntegrationRouteKind.ControlledSideHoleParentBRepIntegration, mappings, new(true, false, 6, 8, 1, "parent-box:10x8x6; +X entry and -X exit faces split with circular inner loops; x7 local patch bounds preserved", ["ControlledPlusXFaceSplitEvidence", "ControlledMinusXExitFaceSplitEvidence", "MaterializedEntryLoop", "MaterializedExitLoop", "StandaloneCylindricalCutWallFaceEvidence"]), new(false, false, "deferred", ["air-region-x10-step-smoke-deferred", "step smoke deferred because cut-wall attachment and shell closure remain incomplete"]), blocker, diagnostics, ["cut-wall-attachment-deferred", "parent-shell-not-closed", "standalone-patch-preserved"], ["controlled fixture only", "controlled +X face entry loop evidence", "controlled -X face exit loop evidence", "no general side-hole support", "no arbitrary face/axis support", "no production route replacement", "no parent topology mutation outside controlled prototype evidence", "CIR remains analysis-only", "Boolean not used", "Boolean not generally admitted", "no STEP exporter/importer change"]);
}
public static AirRegionFaceSplitSummary SplitEntryLoop(AirRegionSummary region, AirRegionBRepPlaceholderPlan placeholders)
@@ -209,6 +214,14 @@ internal static class AirSideHoleParentBRepIntegrationPrototype
return new(region.RegionId, region.Yield.Attachment.FaceSelector, AirRegionFaceSplitStatus.SplitCreated, AirRegionFaceSplitStatus.EntryLoopMaterialized, "CutEntryLoop", "Circle(radius=1)", region.Yield.Profile.Radius, region.Yield.LocalFrameId, "AffectedParentFace", [byRole["CutEntryLoop"].Id], new(true, 2, 1, 1, "parent-box:+X-face(width=8,height=6);inner-circle:r=1", ["ControlledPlusXFaceSplitEvidence", "MaterializedEntryLoop", "CircularInnerLoopEvidence"]), null, diagnostics, ["controlled fixture only", "affected face is +X", "entry loop evidence only", "no arbitrary face splitting", "no Boolean", "parent integration remains partial"]);
}
+ public static AirRegionExitLoopSummary InsertExitLoop(AirRegionSummary region, AirRegionBRepPlaceholderPlan placeholders, AirRegionFaceSplitSummary entrySplit)
+ {
+ if (region.Yield is null) throw new ArgumentException("Side-hole region must carry a yield summary.", nameof(region));
+ var byRole = placeholders.Elements.ToDictionary(e => e.Role, StringComparer.Ordinal);
+ var diagnostics = Stable(["air-region-x10-exit-loop-request-created", "air-region-x10-opposite-face-selected", "air-region-x10-minus-x-exit-face-selected", "air-region-x10-cut-exit-loop-placeholder-consumed", "air-region-x10-circular-exit-loop-created", "air-region-x10-exit-face-split-created", "air-region-x10-inner-exit-loop-evidence-created", "air-region-x10-exit-loop-summary-created", "air-region-x10-exit-loop-insertion-blocker-cleared", "air-region-x10-parent-integration-still-partial", "air-region-x10-no-general-side-hole-support", "air-region-x10-no-production-route-replacement", "air-region-x10-no-boolean"]).ToArray();
+ return new(region.RegionId, "-X", AirRegionExitLoopStatus.ExitLoopMaterialized, "CutExitLoop", "Circle(radius=1)", region.Yield.Profile.Radius, region.Yield.LocalFrameId, [byRole["CutExitLoop"].Id], new(true, 2, 1, 1, "parent-box:-X-face(width=8,height=6);inner-circle:r=1", ["ControlledMinusXExitFaceSplitEvidence", "MaterializedExitLoop", "CircularInnerLoopEvidence", .. entrySplit.TopologySummary.EvidenceRoles.Where(r => r == "MaterializedEntryLoop")]), null, diagnostics, ["controlled fixture only", "exit face is -X", "exit loop evidence only", "entry loop evidence preserved", "no arbitrary face splitting", "no Boolean", "parent integration remains partial"]);
+ }
+
private static AirRegionBRepPlaceholderMaterialization Map(AirRegionBRepPlaceholderElement e, AirRegionMaterializationStatus status, string kind, string role, string? id, string diagnostic) => new(e.Id, e.Role, status, kind, role, id, [diagnostic]);
private static IEnumerable<string> Stable(IEnumerable<string> values) => values.Distinct(StringComparer.Ordinal).OrderBy(x => x, StringComparer.Ordinal);
}
@@ -255,7 +268,9 @@ internal sealed record AirRegionSummary(
[property: System.Text.Json.Serialization.JsonIgnore(Condition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull)]
AirRegionParentIntegrationSummary? ParentIntegration = null,
[property: System.Text.Json.Serialization.JsonIgnore(Condition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull)]
- AirRegionFaceSplitSummary? FaceSplit = null);
+ AirRegionFaceSplitSummary? FaceSplit = null,
+ [property: System.Text.Json.Serialization.JsonIgnore(Condition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull)]
+ AirRegionExitLoopSummary? ExitLoop = null);
internal sealed record AirRegionTraceSummary(
IReadOnlyList<AirRegionSummary> Regions,
@@ -297,26 +312,28 @@ internal static class AirRegionTraceFactory
var decision = AirSideHoleRegionIntegrationSelector.Decide(sideBase, mirror.Summary, boundary);
var placeholders = AirSideHoleBRepPlaceholderPlanner.Plan(sideBase, boundary, decision);
var materialization = AirSideHolePlaceholderMaterializer.MaterializePatch(sideBase, boundary, placeholders);
- var parentIntegration = AirSideHoleParentBRepIntegrationPrototype.Attempt(sideBase, boundary, placeholders, materialization);
var faceSplit = AirSideHoleParentBRepIntegrationPrototype.SplitEntryLoop(sideBase, placeholders);
- var x9Decision = decision with { SelectedRouteKind = AirRegionIntegrationRouteKind.ControlledSideHoleParentBRepIntegration, SelectedStatus = AirRegionIntegrationStatus.PartiallyIntegrated, Recommendation = "controlled parent BRep integration attempted; +X face split and entry loop evidence created; exit loop, cut-wall attachment, and shell closure remain deferred", Diagnostics = Stable([.. decision.Diagnostics, .. materialization.Diagnostics, .. parentIntegration.Diagnostics, .. faceSplit.Diagnostics]).ToArray(), KnownLosses = Stable([.. decision.KnownLosses, .. materialization.KnownLosses, .. parentIntegration.KnownLosses]).ToArray(), Guarantees = Stable([.. decision.Guarantees, .. materialization.Guarantees, .. parentIntegration.Guarantees, .. faceSplit.Guarantees]).ToArray() };
+ var exitLoop = AirSideHoleParentBRepIntegrationPrototype.InsertExitLoop(sideBase, placeholders, faceSplit);
+ var parentIntegration = AirSideHoleParentBRepIntegrationPrototype.Attempt(sideBase, boundary, placeholders, materialization);
+ var x10Decision = decision with { SelectedRouteKind = AirRegionIntegrationRouteKind.ControlledSideHoleParentBRepIntegration, SelectedStatus = AirRegionIntegrationStatus.PartiallyIntegrated, Recommendation = "controlled parent BRep integration attempted; +X entry loop and -X exit loop evidence created; cut-wall attachment and shell closure remain deferred", Diagnostics = Stable([.. decision.Diagnostics, .. materialization.Diagnostics, .. parentIntegration.Diagnostics, .. faceSplit.Diagnostics, .. exitLoop.Diagnostics]).ToArray(), KnownLosses = Stable([.. decision.KnownLosses, .. materialization.KnownLosses, .. parentIntegration.KnownLosses]).ToArray(), Guarantees = Stable([.. decision.Guarantees, .. materialization.Guarantees, .. parentIntegration.Guarantees, .. faceSplit.Guarantees, .. exitLoop.Guarantees]).ToArray() };
var side = sideBase with
{
- StageReached = "region-face-split",
- Provenance = "AIR-REGION-X9 metadata-driven fixture",
- Diagnostics = Stable([.. sideBase.Diagnostics.Where(d => d != "air-region-x2-no-cir-mirror"), .. mirror.Summary.Diagnostics, .. boundary.Diagnostics, .. x9Decision.Diagnostics, .. placeholders.Diagnostics, .. materialization.Diagnostics, .. faceSplit.Diagnostics]).ToArray(),
- KnownLosses = Stable([.. sideBase.KnownLosses, .. mirror.Summary.KnownLosses, .. boundary.KnownLosses, .. x9Decision.KnownLosses, .. placeholders.KnownLosses, .. materialization.KnownLosses]).ToArray(),
- Guarantees = Stable([.. sideBase.Guarantees, .. mirror.Summary.Guarantees, .. boundary.Guarantees, .. x9Decision.Guarantees, .. placeholders.Guarantees, .. materialization.Guarantees]).ToArray(),
+ StageReached = "region-exit-loop",
+ Provenance = "AIR-REGION-X10 metadata-driven fixture",
+ Diagnostics = Stable([.. sideBase.Diagnostics.Where(d => d != "air-region-x2-no-cir-mirror"), .. mirror.Summary.Diagnostics, .. boundary.Diagnostics, .. x10Decision.Diagnostics, .. placeholders.Diagnostics, .. materialization.Diagnostics, .. faceSplit.Diagnostics, .. exitLoop.Diagnostics]).ToArray(),
+ KnownLosses = Stable([.. sideBase.KnownLosses, .. mirror.Summary.KnownLosses, .. boundary.KnownLosses, .. x10Decision.KnownLosses, .. placeholders.KnownLosses, .. materialization.KnownLosses]).ToArray(),
+ Guarantees = Stable([.. sideBase.Guarantees, .. mirror.Summary.Guarantees, .. boundary.Guarantees, .. x10Decision.Guarantees, .. placeholders.Guarantees, .. materialization.Guarantees]).ToArray(),
IntegrationRoute = "ControlledSideHoleParentBRepIntegration",
CirMirror = mirror.Summary,
BrepBoundary = boundary,
- IntegrationDecision = x9Decision,
+ IntegrationDecision = x10Decision,
BrepPlaceholders = placeholders,
Materialization = materialization,
ParentIntegration = parentIntegration,
- FaceSplit = faceSplit
+ FaceSplit = faceSplit,
+ ExitLoop = exitLoop
};
- return Summary([root, side], ["air-region-x1-region-trace-created", "air-region-x1-no-implicit-parent-mutation", "air-region-x1-no-boolean", "air-region-x1-no-brep-emission", "air-region-x1-no-production-route-replacement", "air-region-x1-trace-only", "air-region-x2-yield-contract-created", "air-region-x2-side-hole-yield-created", "air-region-x2-region-locality-enforced", "air-region-x2-explicit-yield-only", "air-region-x2-parent-integration-deferred", "air-region-x2-no-boolean", "air-region-x2-no-brep-emission", "air-region-x2-no-step-smoke", "air-region-x2-trace-only", .. side.CirMirror!.Diagnostics, .. side.BrepBoundary!.Diagnostics, .. side.IntegrationDecision!.Diagnostics, .. side.BrepPlaceholders!.Diagnostics, .. side.Materialization!.Diagnostics, .. side.ParentIntegration!.Diagnostics, .. side.FaceSplit!.Diagnostics], ["escapes only through explicit yield", "no Boolean", "no production route replacement", .. side.CirMirror.Guarantees, .. side.BrepBoundary.Guarantees, .. side.IntegrationDecision.Guarantees, .. side.BrepPlaceholders.Guarantees, .. side.Materialization.Guarantees, .. side.ParentIntegration.Guarantees, .. side.FaceSplit.Guarantees]);
+ return Summary([root, side], ["air-region-x1-region-trace-created", "air-region-x1-no-implicit-parent-mutation", "air-region-x1-no-boolean", "air-region-x1-no-brep-emission", "air-region-x1-no-production-route-replacement", "air-region-x1-trace-only", "air-region-x2-yield-contract-created", "air-region-x2-side-hole-yield-created", "air-region-x2-region-locality-enforced", "air-region-x2-explicit-yield-only", "air-region-x2-parent-integration-deferred", "air-region-x2-no-boolean", "air-region-x2-no-brep-emission", "air-region-x2-no-step-smoke", "air-region-x2-trace-only", .. side.CirMirror!.Diagnostics, .. side.BrepBoundary!.Diagnostics, .. side.IntegrationDecision!.Diagnostics, .. side.BrepPlaceholders!.Diagnostics, .. side.Materialization!.Diagnostics, .. side.ParentIntegration!.Diagnostics, .. side.FaceSplit!.Diagnostics, .. side.ExitLoop!.Diagnostics], ["escapes only through explicit yield", "no Boolean", "no production route replacement", .. side.CirMirror.Guarantees, .. side.BrepBoundary.Guarantees, .. side.IntegrationDecision.Guarantees, .. side.BrepPlaceholders.Guarantees, .. side.Materialization.Guarantees, .. side.ParentIntegration.Guarantees, .. side.FaceSplit.Guarantees, .. side.ExitLoop.Guarantees]);
}
public static AirRegionTraceSummary ForImplicitParentMutationRejected()
diff --git a/docs/air-a1-air-regions-scoped-feature-lowering-audit.md b/docs/air-a1-air-regions-scoped-feature-lowering-audit.md
index e6ce8050..700cf36f 100644
--- a/docs/air-a1-air-regions-scoped-feature-lowering-audit.md
+++ b/docs/air-a1-air-regions-scoped-feature-lowering-audit.md
@@ -662,3 +662,8 @@ AIR-REGION-X8 adds a controlled side-hole parent BRep integration attempt to the
## AIR-REGION-X9 status note
AIR-REGION-X9 advances the side-hole parent integration evidence past the generic X8 `FaceSplitting` blocker. The controlled `+X` face now reports face-split and circular entry-loop evidence with `CutEntryLoop` consumed. Parent integration remains partial with `ExitLoopInsertion` as the next specific blocker; Boolean fallback and general side-hole support remain disallowed.
+
+
+### AIR-REGION-X10 status note
+
+AIR-REGION-X10 addresses the X9 `ExitLoopInsertion` blocker for the controlled side-hole fixture. The trace now reports deterministic `-X` opposite-face exit-loop evidence, consumes/materializes `CutExitLoop`, preserves the X9 `+X` entry-loop evidence, and advances the next blocker to `CutWallAttachment`. Parent integration remains partial; shell closure, STEP/export, Boolean integration, general side-hole support, arbitrary face/axis support, and production route replacement remain out of scope.
diff --git a/docs/air-region-x10-side-hole-exit-loop-insertion.md b/docs/air-region-x10-side-hole-exit-loop-insertion.md
new file mode 100644
index 00000000..c7444bb5
--- /dev/null
+++ b/docs/air-region-x10-side-hole-exit-loop-insertion.md
@@ -0,0 +1,70 @@
+# AIR-REGION-X10 — Side-hole exit loop insertion
+
+## Purpose and scope
+
+AIR-REGION-X10 is a controlled blocker-fix milestone for the existing side-hole `FaceAttachedRegion` fixture. It does not add general side-hole support, arbitrary face/axis support, production Boolean fallback, production route replacement, or broad BRep topology surgery.
+
+## Relationship to AIR-REGION-X9
+
+AIR-REGION-X9 cleared the generic `FaceSplitting` blocker by preserving the full AIR Region evidence chain and adding controlled `+X` parent-face split / entry-loop evidence. X9 intentionally stopped at `ExitLoopInsertion`.
+
+X10 consumes that X9 entry-loop evidence and advances the blocker by creating controlled opposite-face exit-loop evidence for the same fixture.
+
+## Controlled fixture geometry
+
+Fixture: `fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture`.
+
+- Parent box: 10 × 8 × 6.
+- Entry face: `+X`.
+- Exit face: `-X` under the current fixture convention.
+- Profile: `Circle(radius=1)`.
+- Direction: through/inward along the local face normal/X axis.
+- Feature: `SideHole`.
+- Effect: subtractive.
+- Route: region trace / controlled prototype evidence only.
+
+## Exit loop route attempted
+
+The implementation reuses the narrow X9 face-with-inner-loop evidence shape for the opposite side of the box. It deterministically selects the `-X` exit face for the controlled `+X` side-hole fixture, materializes the `CutExitLoop` placeholder as trace/evidence, and records bounded topology evidence for a face with one circular inner loop.
+
+## Outcome A
+
+Outcome A was achieved:
+
+- Exit face selector: `-X`.
+- Exit loop status: `ExitLoopMaterialized`.
+- Exit loop profile: `Circle(radius=1)`.
+- `CutExitLoop` placeholder: consumed/materialized as `region:side-hole:+x:exit-loop`.
+- Topology evidence: two face loops, one inner loop, one circular edge for the controlled exit face evidence.
+- Parent integration remains `PartiallyIntegrated`.
+- The next blocker is `CutWallAttachment`, not `ExitLoopInsertion`.
+
+## Placeholder consumption
+
+X10 consumes `CutExitLoop` in the controlled parent integration path. X6 placeholder planning remains stable: the placeholder identity is still `region:side-hole:+x:exit-loop`, and X10 reports it as materialized in the exit-loop summary and parent-integration placeholder mappings.
+
+## Entry-loop preservation
+
+The X9 `faceSplit` section remains present. It still reports `+X`, `SplitCreated`, `EntryLoopMaterialized`, `Circle(radius=1)`, `CutEntryLoop`, and the bounded entry-loop topology evidence.
+
+## Parent integration status
+
+Parent integration remains partial. X10 does not claim cut-wall attachment, parent shell closure, full topology validation, or STEP export. The parent integration blocker advances to `CutWallAttachment` because entry and exit loop evidence now exist, but the preserved standalone cylindrical wall has not been attached into a closed parent shell.
+
+## Boolean policy
+
+No Boolean fallback is invoked or admitted. CIR remains analysis-only and does not gain topology authority.
+
+## Topology and STEP evidence
+
+X10 records trace/evidence topology for the controlled `-X` exit face loop: face loops, inner loops, and circular edge count. It does not emit STEP and does not claim STEP smoke success.
+
+## Tests run
+
+Validation included CLI build/help, side-hole text and JSON traces, invalid implicit-parent-mutation JSON trace, parser-backed box trace, and focused .NET test filters recorded in the PR summary.
+
+## Recommended next milestone
+
+Recommended: **AIR-REGION-X11 — Controlled cut-wall attachment / entry-exit wall integration**.
+
+X11 should bind the preserved cylindrical cut-wall evidence to the controlled `+X` entry loop and `-X` exit loop, then truthfully report whether parent shell closure/topology validation becomes available.
diff --git a/docs/air-region-x6-side-hole-brep-placeholders.md b/docs/air-region-x6-side-hole-brep-placeholders.md
index b3d8a8c9..0fa0e4c6 100644
--- a/docs/air-region-x6-side-hole-brep-placeholders.md
+++ b/docs/air-region-x6-side-hole-brep-placeholders.md
@@ -113,3 +113,8 @@ AIR-REGION-X8 consumes all five X6 placeholders in a controlled parent integrati
## AIR-REGION-X9 CutEntryLoop consumption note
AIR-REGION-X9 consumes the stable `CutEntryLoop` placeholder for the controlled `+X` side-hole fixture as trace/evidence for a circular entry inner loop on the affected parent face. The placeholder ID remains stable (`region:side-hole:+x:entry-loop`). This is controlled fixture evidence only; it does not introduce arbitrary planar face splitting or production topology mutation.
+
+
+## AIR-REGION-X10 CutExitLoop consumption note
+
+AIR-REGION-X10 consumes the stable `CutExitLoop` placeholder for the controlled `+X` side-hole fixture as trace/evidence for a circular exit inner loop on the deterministic opposite `-X` parent face. The placeholder ID remains stable (`region:side-hole:+x:exit-loop`). This is controlled fixture evidence only; it does not introduce arbitrary face splitting, general side-hole support, or production topology mutation.
diff --git a/docs/air-region-x8-side-hole-parent-integration-attempt.md b/docs/air-region-x8-side-hole-parent-integration-attempt.md
index e01cdc5a..8aa1576b 100644
--- a/docs/air-region-x8-side-hole-parent-integration-attempt.md
+++ b/docs/air-region-x8-side-hole-parent-integration-attempt.md
@@ -73,3 +73,8 @@ Recommended: **AIR-REGION-X9 — Controlled side-hole parent face split and loop
## AIR-REGION-X9 update
AIR-REGION-X9 clears the generic X8 `FaceSplitting` blocker for the controlled `+X` side-hole fixture by adding trace/evidence for a controlled parent face split with a circular entry inner loop. Parent integration remains partial: the next blocker is `ExitLoopInsertion`, followed by cut-wall attachment and shell closure. No Boolean fallback, production route replacement, general side-hole support, arbitrary face/axis support, STEP exporter/importer change, or production BRep topology behavior change is introduced.
+
+
+## AIR-REGION-X10 blocker advancement
+
+AIR-REGION-X10 advances the X8/X9 parent-integration blocker past `ExitLoopInsertion` for the controlled fixture by materializing `CutExitLoop` evidence on the deterministic `-X` opposite face. The remaining parent-integration blocker is now `CutWallAttachment`, with shell closure and STEP/export still deferred.
diff --git a/docs/air-region-x9-side-hole-face-splitting.md b/docs/air-region-x9-side-hole-face-splitting.md
index b7246ac0..4ca83757 100644
--- a/docs/air-region-x9-side-hole-face-splitting.md
+++ b/docs/air-region-x9-side-hole-face-splitting.md
@@ -75,3 +75,8 @@ X9 was validated with the requested CLI commands and focused .NET test filters.
Recommended: **AIR-REGION-X10 — Controlled exit loop / cut-wall parent integration**.
X9 cleared the entry face-splitting blocker for the controlled fixture. The next blocker is no longer generic face splitting; it is controlled opposite-face exit loop insertion plus attaching the preserved cylindrical cut-wall evidence and closing the parent shell.
+
+
+## AIR-REGION-X10 follow-up
+
+AIR-REGION-X10 preserves the X9 `+X` entry-loop evidence and adds controlled opposite-side `-X` exit-loop evidence. The `CutExitLoop` placeholder is now consumed/materialized in the controlled trace path, and the parent-integration blocker advances from `ExitLoopInsertion` to `CutWallAttachment`. Parent integration remains partial; cut-wall attachment, shell closure, topology validation, STEP/export, Boolean integration, and general side-hole support are still not claimed.
diff --git a/docs/air-x6-aetheris-trace-lowering-report-cli.md b/docs/air-x6-aetheris-trace-lowering-report-cli.md
index d1af02fe..7c8bb069 100644
--- a/docs/air-x6-aetheris-trace-lowering-report-cli.md
+++ b/docs/air-x6-aetheris-trace-lowering-report-cli.md
@@ -201,3 +201,8 @@ The side-hole region fixture now includes a `Region parent integration` text sec
## AIR-REGION-X9 side-hole face split trace section
For `fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture`, `aetheris trace` now includes a `Region face split` text section and a JSON `regions.regions[].faceSplit` object. The section records the controlled `+X` affected face, `SplitCreated` face split status, `EntryLoopMaterialized` entry loop status, `Circle(radius=1)`, consumed `CutEntryLoop` placeholder identity, and bounded loop evidence. Parent integration remains partial with a more specific `ExitLoopInsertion` blocker.
+
+
+## AIR-REGION-X10 side-hole exit loop trace section
+
+For `fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture`, `aetheris trace` now includes a `Region exit loop` text section and a JSON `regions.regions[].exitLoop` object. The section records deterministic `-X` exit face selection, `ExitLoopMaterialized`, `Circle(radius=1)`, consumed `CutExitLoop` placeholder identity, and bounded loop evidence. Parent integration remains partial and now reports `CutWallAttachment` as the next blocker.
diff --git a/fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture b/fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture
index b09f5e51..56eded74 100644
--- a/fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture
+++ b/fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture
@@ -1,6 +1,6 @@
// case: side-hole-face-attached-region
// expected: valid
-// expected-stage: region-face-split
+// expected-stage: region-exit-loop
// expected-region-kind: FaceAttachedRegion
// expected-effect: Subtractive
// expected-yield: YieldSubtractiveVolume
@@ -40,13 +40,15 @@
// expected-face-split: SplitCreated
// expected-entry-loop: EntryLoopMaterialized
// expected-placeholder-materialized: CutEntryLoop
-// expected-blocker-category: ExitLoopInsertion
+// expected-exit-loop: ExitLoopMaterialized
+// expected-exit-face: -X
+// expected-blocker-category: CutWallAttachment
// expected-current-evidence: standalone-patch-materialized
// expected-placeholder-materialized: CutEntryLoop
// expected-placeholder-materialized: CutExitLoop
// expected-placeholder-materialized: CutWallFace
// expected-cylindrical-faces-min: 1
-// description: Face-attached side-hole fixture with controlled parent face split and entry-loop evidence with parent integration still partial.
+// description: Face-attached side-hole fixture with controlled parent entry-loop and opposite-side exit-loop evidence with parent integration still partial.
solid box = Box(width: 10, depth: 8, height: 6);
region sideHole on box.face("+X") {