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.csindex b5866943..3fc42869 100644--- a/Aetheris.CLI.Tests/AirTraceCommandTests.cs+++ b/Aetheris.CLI.Tests/AirTraceCommandTests.cs@@ -342,7 +342,7 @@ public sealed class AirTraceCommandTestsusing 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 AirTraceCommandTestsAssert.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 AirTraceCommandTestsAssert.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 AirTraceCommandTestsusing 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 AirTraceCommandTestsvar 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 AirTraceCommandTestsAssert.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.csindex b1eb2342..b84c5d68 100644--- a/Aetheris.CLI/AirTrace.cs+++ b/Aetheris.CLI/AirTrace.cs@@ -192,18 +192,18 @@ internal static class AirTraceReportBuilderprivate 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 AirTraceTextRendererforeach (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.csindex 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 AirSideHolePlaceholderMaterializerreturn 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 AirSideHoleParentBRepIntegrationPrototypereturn 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 AirRegionTraceFactoryvar 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.mdindex 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 noteAIR-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.mdnew file mode 100644index 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.mdindex 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 noteAIR-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.mdindex 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 updateAIR-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.mdindex 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.mdindex 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 sectionFor `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.firmfixtureindex 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") {