Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Add controlled side-hole cut-wall trace
Yuechen Lid7bf6a6cb21b
diff --git a/Aetheris.CLI.Tests/AirTraceCommandTests.cs b/Aetheris.CLI.Tests/AirTraceCommandTests.csindex 3fc42869..50c64f0a 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-exit-loop", root.GetProperty("actualStageReached").GetString());+ Assert.Equal("region-shell-closure-blocked", 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: CutWallAttachment", output);+ Assert.Contains("Category: ShellClosure", 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("CutWallAttachment", parent.GetProperty("blocker").GetProperty("category").GetString());- Assert.Equal("controlled-side-hole-cut-wall-attachment-deferred", parent.GetProperty("blocker").GetProperty("code").GetString());+ Assert.Equal("ShellClosure", parent.GetProperty("blocker").GetProperty("category").GetString());+ Assert.Equal("controlled-side-hole-shell-closure-blocked", parent.GetProperty("blocker").GetProperty("code").GetString());}[Fact]@@ -570,6 +570,41 @@ public sealed class AirTraceCommandTestsAssert.Equal(first, second);}++ [Fact]+ public void TraceSideHoleRegion_CutWall_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 cut wall / shell closure", output);+ Assert.Contains("Status: CutWallAttached", output);+ Assert.Contains("Cut wall: cylindrical face materialized", output);+ Assert.Contains("Entry loop: materialized", output);+ Assert.Contains("Exit loop: materialized", output);+ Assert.Contains("Placeholder consumed: CutWallFace", output);+ Assert.Contains("Shell closure: Blocked", output);+ Assert.Contains("Category: ShellClosure", output);+ }++ [Fact]+ public void TraceSideHoleRegion_CutWall_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 cutWall = side.GetProperty("cutWallAttachment");+ Assert.Equal("CutWallAttached", cutWall.GetProperty("status").GetString());+ Assert.Equal("CylindricalCutWallFace", cutWall.GetProperty("cutWallRole").GetString());+ Assert.Contains("region:side-hole:+x:cut-wall", cutWall.GetProperty("materializedPlaceholderIds").EnumerateArray().Select(x => x.GetString()));+ Assert.Equal(JsonValueKind.Null, cutWall.GetProperty("blocker").ValueKind);+ var shell = side.GetProperty("shellClosure");+ Assert.Equal("Blocked", shell.GetProperty("status").GetString());+ Assert.False(shell.GetProperty("closed").GetBoolean());+ Assert.Equal("ShellClosure", shell.GetProperty("blocker").GetProperty("category").GetString());+ }+[Fact]public void TraceSideHoleRegion_FaceSplit_DefaultText(){@@ -607,7 +642,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("CutWallAttachment", side.GetProperty("parentIntegration").GetProperty("blocker").GetProperty("category").GetString());+ Assert.Equal("ShellClosure", side.GetProperty("parentIntegration").GetProperty("blocker").GetProperty("category").GetString());Assert.DoesNotContain("controlled-side-hole-parent-face-splitting-missing", output, StringComparison.Ordinal);}@@ -619,8 +654,8 @@ 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("CutWallAttachment", parent.GetProperty("blocker").GetProperty("category").GetString());- Assert.Equal("deferred", parent.GetProperty("stepSmoke").GetProperty("status").GetString());+ Assert.Equal("ShellClosure", parent.GetProperty("blocker").GetProperty("category").GetString());+ Assert.Equal("Unavailable", parent.GetProperty("stepSmoke").GetProperty("status").GetString());}[Fact]@@ -676,7 +711,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("ExitLoopMaterialized", side.GetProperty("exitLoop").GetProperty("exitLoopStatus").GetString());- Assert.Equal("CutWallAttachment", side.GetProperty("parentIntegration").GetProperty("blocker").GetProperty("category").GetString());+ Assert.Equal("ShellClosure", side.GetProperty("parentIntegration").GetProperty("blocker").GetProperty("category").GetString());Assert.DoesNotContain("controlled-side-hole-exit-loop-insertion-deferred", output, StringComparison.Ordinal);}@@ -699,8 +734,8 @@ 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("CutWallAttachment", parent.GetProperty("blocker").GetProperty("category").GetString());- Assert.Equal("deferred", parent.GetProperty("stepSmoke").GetProperty("status").GetString());+ Assert.Equal("ShellClosure", parent.GetProperty("blocker").GetProperty("category").GetString());+ Assert.Equal("Unavailable", parent.GetProperty("stepSmoke").GetProperty("status").GetString());Assert.False(parent.GetProperty("topologySummary").GetProperty("closed").GetBoolean());}diff --git a/Aetheris.CLI/AirTrace.cs b/Aetheris.CLI/AirTrace.csindex b84c5d68..b4cd6442 100644--- a/Aetheris.CLI/AirTrace.cs+++ b/Aetheris.CLI/AirTrace.cs@@ -192,11 +192,11 @@ internal static class AirTraceReportBuilderprivate static AirTraceReport BuildSideHoleFaceAttachedRegionFixture(FirmFixture fixture){var regions = AirRegionTraceFactory.ForFaceAttachedSideHoleDeferred();- var actualStage = "region-exit-loop";+ var actualStage = "region-shell-closure-blocked";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-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"),+ return new("AIR-REGION-X11", "trace", "lowering", "firmfixture", fixture.CaseName, expectationSatisfied, "FaceAttachedRegion side-hole preserves +X entry-loop and -X exit-loop evidence, attaches controlled cylindrical cut-wall evidence, and stops truthfully at shell closure.",+ new("RegionFixture", "ControlledSideHoleParentBRepIntegration", "none", "none", "metadata-driven-region-contract", fixture.CaseName, fixture.CaseName, "AIR-REGION-X11"),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 and -X exit face split evidence created; parent integration partial"),@@ -464,6 +464,41 @@ internal static class AirTraceTextRendererforeach (var guarantee in el.Guarantees) b.AppendLine($" - {guarantee}");}+ if (region.CutWallAttachment is not null || region.ShellClosure is not null)+ {+ b.AppendLine(" Region cut wall / shell closure");+ b.AppendLine($" Region: {region.RegionId}");+ if (region.CutWallAttachment is not null)+ {+ var cw = region.CutWallAttachment;+ b.AppendLine($" Status: {cw.Status}");+ b.AppendLine($" Cut wall: {(cw.Status == Aetheris.Kernel.Core.Air.Regions.AirRegionCutWallAttachmentStatus.CutWallAttached ? "cylindrical face materialized" : "blocked")}");+ b.AppendLine(" Entry loop: materialized");+ b.AppendLine(" Exit loop: materialized");+ b.AppendLine(" Placeholder consumed: CutWallFace");+ }+ if (region.ShellClosure is not null)+ {+ var sc = region.ShellClosure;+ b.AppendLine($" Shell closure: {sc.Status}");+ b.AppendLine($" Parent integration: {region.ParentIntegration?.Status.ToString() ?? region.IntegrationStatus.ToString()}");+ b.AppendLine($" STEP smoke: {region.ParentIntegration?.StepSmoke.Status.ToLowerInvariant() ?? "unavailable"}");+ b.AppendLine(" Blocker:");+ if (sc.Blocker is null)+ {+ b.AppendLine(" Category: none");+ b.AppendLine(" Code: none");+ b.AppendLine(" Message: none");+ }+ else+ {+ b.AppendLine($" Category: {sc.Blocker.Category}");+ b.AppendLine($" Code: {sc.Blocker.Code}");+ b.AppendLine($" Message: {sc.Blocker.Message}");+ }+ }+ }+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 5fd0397f..ff42147a 100644--- a/Aetheris.Kernel.Core/Air/AirRegions.cs+++ b/Aetheris.Kernel.Core/Air/AirRegions.cs@@ -17,6 +17,8 @@ internal enum AirRegionIntegrationBlockerCategory { MissingBRepApi, FaceSplittininternal 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 }+internal enum AirRegionCutWallAttachmentStatus { CutWallAttached, PartiallyAttached, Blocked, Deferred, Rejected, Unsupported }+internal enum AirRegionShellClosureStatus { Closed, Open, PartiallyClosed, Blocked, Unavailable }@@ -51,6 +53,8 @@ internal sealed record AirRegionFaceSplitBlocker(AirRegionIntegrationBlockerCateinternal 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 AirRegionCutWallAttachmentSummary(string SourceRegionId, AirRegionCutWallAttachmentStatus Status, string CutWallRole, IReadOnlyList<string> MaterializedPlaceholderIds, AirRegionIntegrationBlocker? Blocker, IReadOnlyList<string> Diagnostics, IReadOnlyList<string> Guarantees);+internal sealed record AirRegionShellClosureSummary(string SourceRegionId, AirRegionShellClosureStatus Status, bool? Closed, AirRegionIntegrationBlocker? 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);@@ -175,13 +179,14 @@ internal static class AirSideHolePlaceholderMaterializer}+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);}internal static class AirSideHoleParentBRepIntegrationPrototype{- public static AirRegionParentIntegrationSummary Attempt(AirRegionSummary region, AirRegionBRepBoundarySummary boundary, AirRegionBRepPlaceholderPlan placeholders, AirRegionSideHoleMaterializationSummary patch)+ public static AirRegionParentIntegrationSummary AttemptCutWallAttachment(AirRegionSummary region, AirRegionBRepBoundarySummary boundary, AirRegionBRepPlaceholderPlan placeholders, AirRegionSideHoleMaterializationSummary patch, AirRegionFaceSplitSummary entrySplit, AirRegionExitLoopSummary exitLoop){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);@@ -190,20 +195,20 @@ internal static class AirSideHoleParentBRepIntegrationPrototypeMap(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.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", "BlockedAfterEntryExitFaceSplits", null, "air-region-x10-parent-integration-still-partial")+ Map(byRole["CutWallFace"], AirRegionMaterializationStatus.Materialized, "CylindricalFaceEvidence", "CylindricalCutWallFace", "region:side-hole:+x:cut-wall", "air-region-x11-cut-wall-placeholder-consumed"),+ Map(byRole["RegionIntegrationPatch"], AirRegionMaterializationStatus.Deferred, "ParentIntegrationPatch", "BlockedAtShellClosure", null, "air-region-x11-shell-closure-blocked")};var blocker = new AirRegionIntegrationBlocker(- 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",+ AirRegionIntegrationBlockerCategory.ShellClosure,+ "controlled-side-hole-shell-closure-blocked",+ "The controlled cylindrical cut wall is attached between the +X entry loop and -X exit loop evidence, but parent shell closure is not claimed because the RegionIntegrationPatch is still deferred pending controlled parent face patch validation.",+ "ShellClosure",[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"]);+ ["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", "x11-cylindrical-cut-wall-attached"],+ "Materialize the controlled RegionIntegrationPatch and validate parent shell closure without broad topology surgery.",+ ["air-region-x11-cylindrical-cut-wall-attached", "air-region-x11-shell-closure-blocker"]);+ 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", "air-region-x11-cut-wall-request-created", "air-region-x11-entry-loop-evidence-consumed", "air-region-x11-exit-loop-evidence-consumed", "air-region-x11-cut-wall-placeholder-consumed", "air-region-x11-cylindrical-cut-wall-attached", "air-region-x11-cut-wall-face-materialized", "air-region-x11-shell-closure-blocker", "air-region-x11-no-fake-parent-integration", "air-region-x11-controlled-fixture-only", "air-region-x11-no-general-side-hole-support", "air-region-x11-no-production-route-replacement", "air-region-x11-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, 7, 9, 1, "parent-box:10x8x6; +X entry and -X exit faces split with circular inner loops; cylindrical cut wall attached; integration patch deferred", ["ControlledPlusXFaceSplitEvidence", "ControlledMinusXExitFaceSplitEvidence", "MaterializedEntryLoop", "MaterializedExitLoop", "CylindricalCutWallFace", "ShellClosureBlockedEvidence"]), new(false, false, "Unavailable", ["air-region-x11-step-smoke-unavailable", "step smoke unavailable because shell closure remains blocked"]), blocker, diagnostics, ["parent-shell-not-closed", "region-integration-patch-deferred", "step-smoke-unavailable"], ["controlled fixture only", "controlled +X face entry loop evidence", "controlled -X face exit loop evidence", "controlled cylindrical cut-wall attachment 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)@@ -221,6 +226,22 @@ internal static class AirSideHoleParentBRepIntegrationPrototypevar 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"]);}+ public static AirRegionCutWallAttachmentSummary AttachCutWall(AirRegionSummary region, AirRegionBRepPlaceholderPlan placeholders, AirRegionFaceSplitSummary entrySplit, AirRegionExitLoopSummary exitLoop)+ {+ 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-x11-cut-wall-request-created", "air-region-x11-entry-loop-evidence-consumed", "air-region-x11-exit-loop-evidence-consumed", "air-region-x11-cut-wall-placeholder-consumed", "air-region-x11-cylindrical-cut-wall-attached", "air-region-x11-cut-wall-face-materialized", "air-region-x11-current-evidence-preserved", "air-region-x11-controlled-fixture-only", "air-region-x11-no-general-side-hole-support", "air-region-x11-no-production-route-replacement", "air-region-x11-cir-remains-analysis-only", "air-region-x11-no-boolean"]).ToArray();+ return new(region.RegionId, AirRegionCutWallAttachmentStatus.CutWallAttached, "CylindricalCutWallFace", [byRole["CutWallFace"].Id], null, diagnostics, ["controlled fixture only", "entry loop evidence preserved", "exit loop evidence preserved", "CutWallFace placeholder consumed", "cylindrical cut wall attached", "CIR remains analysis-only", "Boolean not used", "no general side-hole support", "no arbitrary face/axis support", "no production route replacement"]);+ }++ public static AirRegionShellClosureSummary AttemptShellClosure(AirRegionSummary region, AirRegionBRepPlaceholderPlan placeholders, AirRegionCutWallAttachmentSummary cutWall)+ {+ 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 blocker = new AirRegionIntegrationBlocker(AirRegionIntegrationBlockerCategory.ShellClosure, "controlled-side-hole-region-integration-patch-deferred", "Cut-wall attachment succeeded for the controlled +X/-X/radius=1 evidence chain, but parent shell closure remains blocked until the RegionIntegrationPatch is materialized and validated as a closed parent shell.", "ShellClosure", [byRole["RegionIntegrationPatch"].Id], ["x9-entry-loop-materialized", "x10-exit-loop-materialized", "x11-cut-wall-attached"], "Materialize only the controlled RegionIntegrationPatch and run shell/body closure validation before STEP smoke.", ["air-region-x11-shell-closure-blocker", "air-region-x11-blocker-recorded"]);+ var diagnostics = Stable(["air-region-x11-shell-closure-attempt-created", "air-region-x11-cut-wall-attachment-consumed", "air-region-x11-region-integration-patch-still-deferred", "air-region-x11-shell-closure-blocker", "air-region-x11-blocker-recorded", "air-region-x11-no-fake-parent-integration", "air-region-x11-step-smoke-unavailable", .. blocker.Diagnostics]).ToArray();+ return new(region.RegionId, AirRegionShellClosureStatus.Blocked, false, blocker, diagnostics, ["cut wall attachment is real in controlled trace evidence", "parent shell closure not claimed", "STEP smoke unavailable until shell closure", "no Boolean", "no production route replacement"]);+ }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);@@ -270,7 +291,11 @@ internal sealed record AirRegionSummary([property: System.Text.Json.Serialization.JsonIgnore(Condition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull)]AirRegionFaceSplitSummary? FaceSplit = null,[property: System.Text.Json.Serialization.JsonIgnore(Condition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull)]- AirRegionExitLoopSummary? ExitLoop = null);+ AirRegionExitLoopSummary? ExitLoop = null,+ [property: System.Text.Json.Serialization.JsonIgnore(Condition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull)]+ AirRegionCutWallAttachmentSummary? CutWallAttachment = null,+ [property: System.Text.Json.Serialization.JsonIgnore(Condition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull)]+ AirRegionShellClosureSummary? ShellClosure = null);internal sealed record AirRegionTraceSummary(IReadOnlyList<AirRegionSummary> Regions,@@ -314,12 +339,14 @@ internal static class AirRegionTraceFactoryvar materialization = AirSideHolePlaceholderMaterializer.MaterializePatch(sideBase, boundary, placeholders);var faceSplit = AirSideHoleParentBRepIntegrationPrototype.SplitEntryLoop(sideBase, placeholders);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 parentIntegration = AirSideHoleParentBRepIntegrationPrototype.AttemptCutWallAttachment(sideBase, boundary, placeholders, materialization, faceSplit, exitLoop);+ var cutWallAttachment = AirSideHoleParentBRepIntegrationPrototype.AttachCutWall(sideBase, placeholders, faceSplit, exitLoop);+ var shellClosure = AirSideHoleParentBRepIntegrationPrototype.AttemptShellClosure(sideBase, placeholders, cutWallAttachment);+ var x10Decision = decision with { SelectedRouteKind = AirRegionIntegrationRouteKind.ControlledSideHoleParentBRepIntegration, SelectedStatus = AirRegionIntegrationStatus.PartiallyIntegrated, Recommendation = "controlled parent BRep integration attempted; +X entry loop, -X exit loop, and cylindrical cut-wall attachment evidence created; shell closure remains blocked on parent face patch validation", Diagnostics = Stable([.. decision.Diagnostics, .. materialization.Diagnostics, .. parentIntegration.Diagnostics, .. faceSplit.Diagnostics, .. exitLoop.Diagnostics, .. cutWallAttachment.Diagnostics, .. shellClosure.Diagnostics]).ToArray(), KnownLosses = Stable([.. decision.KnownLosses, .. materialization.KnownLosses, .. parentIntegration.KnownLosses]).ToArray(), Guarantees = Stable([.. decision.Guarantees, .. materialization.Guarantees, .. parentIntegration.Guarantees, .. faceSplit.Guarantees, .. exitLoop.Guarantees, .. cutWallAttachment.Guarantees, .. shellClosure.Guarantees]).ToArray() };var side = sideBase with{- StageReached = "region-exit-loop",- Provenance = "AIR-REGION-X10 metadata-driven fixture",+ StageReached = "region-shell-closure-blocked",+ Provenance = "AIR-REGION-X11 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(),@@ -331,9 +358,11 @@ internal static class AirRegionTraceFactoryMaterialization = materialization,ParentIntegration = parentIntegration,FaceSplit = faceSplit,- ExitLoop = exitLoop+ ExitLoop = exitLoop,+ CutWallAttachment = cutWallAttachment,+ ShellClosure = shellClosure};- 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]);+ 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, .. side.CutWallAttachment!.Diagnostics, .. side.ShellClosure!.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, .. side.CutWallAttachment.Guarantees, .. side.ShellClosure.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 700cf36f..b99c2043 100644--- a/docs/air-a1-air-regions-scoped-feature-lowering-audit.md+++ b/docs/air-a1-air-regions-scoped-feature-lowering-audit.md@@ -667,3 +667,7 @@ AIR-REGION-X9 advances the side-hole parent integration evidence past the generi### AIR-REGION-X10 status noteAIR-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.++## AIR-REGION-X11 status note++AIR-REGION-X11 removes the controlled `CutWallAttachment` blocker for the side-hole fixture by attaching cylindrical cut-wall evidence between the materialized entry and exit loops. The fixture now truthfully stops at `region-shell-closure-blocked` with parent integration `PartiallyIntegrated`, shell closure `Blocked`, and STEP smoke `Unavailable`.diff --git a/docs/air-region-x10-side-hole-exit-loop-insertion.md b/docs/air-region-x10-side-hole-exit-loop-insertion.mdindex c7444bb5..45c197dc 100644--- a/docs/air-region-x10-side-hole-exit-loop-insertion.md+++ b/docs/air-region-x10-side-hole-exit-loop-insertion.md@@ -68,3 +68,7 @@ Validation included CLI build/help, side-hole text and JSON traces, invalid implRecommended: **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.++## AIR-REGION-X11 update++AIR-REGION-X11 consumes the X9 entry-loop evidence and X10 exit-loop evidence, attaches the controlled cylindrical `CutWallFace` evidence, and advances the precise blocker to `ShellClosure`. Parent integration remains `PartiallyIntegrated`; STEP smoke remains unavailable until the controlled `RegionIntegrationPatch` is materialized and shell closure is validated.diff --git a/docs/air-region-x11-side-hole-cut-wall-shell-closure.md b/docs/air-region-x11-side-hole-cut-wall-shell-closure.mdnew file mode 100644index 00000000..c79d5ca8--- /dev/null+++ b/docs/air-region-x11-side-hole-cut-wall-shell-closure.md@@ -0,0 +1,76 @@+# AIR-REGION-X11 — Side-hole cut-wall attachment and shell closure++## Purpose and scope++AIR-REGION-X11 directly addresses the AIR-REGION-X10 `CutWallAttachment` blocker for the controlled golden-path side-hole fixture only:++- parent box: `10 x 8 x 6`;+- entry face: `+X`;+- exit face: `-X`;+- circular through-hole radius: `1`;+- path: side-hole `FaceAttachedRegion` trace path only.++This milestone does not add general side-hole support, arbitrary face/axis support, production route replacement, grammar expansion, Boolean fallback, or STEP exporter/importer changes.++## Relationship to AIR-REGION-X10++X10 materialized the controlled opposite-side exit loop and advanced the blocker from `ExitLoopInsertion` to `CutWallAttachment`. X11 consumes that existing entry/exit-loop evidence and attaches the controlled cylindrical cut-wall evidence between them.++## Controlled fixture geometry++The fixture remains:++`fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture`++The trace preserves the full chain from `RootRegion` through side-hole yield, CIR mirror, BRep boundary contract, route decision, placeholders, standalone patch evidence, entry loop, exit loop, and now cut-wall attachment / shell-closure evidence.++## Cut-wall attachment route attempted++The bounded prototype route is `ControlledSideHoleParentBRepIntegration`. It consumes the X9 `CutEntryLoop`, the X10 `CutExitLoop`, and the X7 cylindrical cut-wall evidence. It reports `CutWallAttached` for the controlled cylindrical cut-wall face and keeps the route explicitly non-production.++## Placeholder consumption++- `CutEntryLoop`: preserved as materialized entry-loop evidence.+- `CutExitLoop`: preserved as materialized exit-loop evidence.+- `CutWallFace`: consumed/materialized as `CylindricalCutWallFace` evidence.+- `RegionIntegrationPatch`: still deferred; this is the precise shell-closure blocker.++## Outcome++Outcome is partial A: cut-wall attachment succeeds for the controlled evidence chain, but full parent shell closure is not claimed.++- Cut wall status: `CutWallAttached`.+- Parent integration status: `PartiallyIntegrated`.+- Blocker category: `ShellClosure`.+- Stage: `region-shell-closure-blocked`.++## Shell closure status++Shell closure is `Blocked`. The trace records that the controlled cylindrical cut wall is attached, but the parent shell is not closed because `RegionIntegrationPatch` remains deferred pending controlled parent face patch validation.++## STEP smoke status++STEP smoke is `Unavailable` because closed parent-shell/body evidence is not yet available. No STEP exporter/importer behavior was changed.++## CIR authority separation++CIR remains an analysis-only mirror. It provides occupancy/containment/bounds side-channel evidence and continues to deny topology authority, face identity, loop identity, BRepPlan role parity, and STEP export authority.++## Boolean policy++Boolean was not used. Boolean is not the AIR Region model, not generally admitted, and not used as a fallback in this milestone.++## Generalization meaning++This is meaningful progression toward a side-hole golden path: the specific X10 blocker (`CutWallAttachment`) is removed and the next blocker is narrowed to `ShellClosure` / controlled `RegionIntegrationPatch` validation. It remains controlled fixture-only work and is not general side-hole support.++## Tests run++- `dotnet build Aetheris.CLI/Aetheris.CLI.csproj -f net10.0`+- `dotnet run --project Aetheris.CLI -f net10.0 -- trace --fixture fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture`+- `dotnet run --project Aetheris.CLI -f net10.0 -- trace --fixture fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfixture --json`+- focused CLI cut-wall/side-hole tests during development.++## Recommended next milestone++AIR-REGION-X12 — Fix the controlled `ShellClosure` / `RegionIntegrationPatch` blocker, then run STEP smoke only after closed parent-shell/body evidence is available.diff --git a/docs/air-region-x7-side-hole-materialization-golden-path.md b/docs/air-region-x7-side-hole-materialization-golden-path.mdindex 803ec3fc..c0ebd680 100644--- a/docs/air-region-x7-side-hole-materialization-golden-path.md+++ b/docs/air-region-x7-side-hole-materialization-golden-path.md@@ -95,3 +95,7 @@ Recommended next: **AIR-REGION-X8 — Side-hole materialization artifact corpus## AIR-REGION-X8 parent integration attempt noteAIR-REGION-X8 consumes the X7 standalone patch evidence during a controlled parent BRep integration attempt. The attempt remains truthful Outcome B: the cylindrical cut-wall evidence is preserved, but parent integration is blocked at parent face splitting and entry/exit loop insertion.++## AIR-REGION-X11 update++The standalone X7 cylindrical patch evidence is now consumed by the controlled parent-integration trace as `CylindricalCutWallFace` evidence between the X9 entry loop and X10 exit loop. The cut-wall blocker is cleared for the fixture, but parent shell closure is still blocked on `RegionIntegrationPatch` validation.diff --git a/docs/air-x6-aetheris-trace-lowering-report-cli.md b/docs/air-x6-aetheris-trace-lowering-report-cli.mdindex 7c8bb069..a10b9a71 100644--- a/docs/air-x6-aetheris-trace-lowering-report-cli.md+++ b/docs/air-x6-aetheris-trace-lowering-report-cli.md@@ -206,3 +206,7 @@ For `fixtures/Firmament/Region/valid/side-hole-face-attached-region.valid.firmfi## AIR-REGION-X10 side-hole exit loop trace sectionFor `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.++## AIR-REGION-X11 trace note++Side-hole region traces now include a `Region cut wall / shell closure` section for the controlled fixture. The section reports cut-wall attachment status, entry/exit-loop preservation, `CutWallFace` placeholder consumption, shell-closure status, parent-integration status, STEP smoke status, and the precise blocker when shell closure is not complete.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 56eded74..8adefb89 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-exit-loop+// expected-stage: region-shell-closure-blocked// expected-region-kind: FaceAttachedRegion// expected-effect: Subtractive// expected-yield: YieldSubtractiveVolume@@ -22,7 +22,7 @@// expected-brep-boundary: planned-contract-only// expected-entry-boundary: circular-entry-loop// expected-exit-boundary: opposite-side-exit-deferred-// expected-cut-wall: cylindrical-cut-wall-intent+// expected-cut-wall: CutWallAttached// expected-brep-role: CutEntryLoop// expected-brep-role: CutWallFace// expected-brep-loss: no-emitted-entry-loop-identity@@ -42,12 +42,14 @@// expected-placeholder-materialized: CutEntryLoop// expected-exit-loop: ExitLoopMaterialized// expected-exit-face: -X-// expected-blocker-category: CutWallAttachment+// expected-blocker-category: ShellClosure// expected-current-evidence: standalone-patch-materialized// expected-placeholder-materialized: CutEntryLoop// expected-placeholder-materialized: CutExitLoop// expected-placeholder-materialized: CutWallFace+// expected-shell-closure: Blocked// expected-cylindrical-faces-min: 1+// expected-step-smoke: Unavailable// 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);