Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Expose PMI provenance and semantic face ownership
Yuechen Libcd4dba69843
diff --git a/Aetheris.Server.Tests/KernelApiIntegrationTests.cs b/Aetheris.Server.Tests/KernelApiIntegrationTests.csindex 119d9f0f..2825a094 100644--- a/Aetheris.Server.Tests/KernelApiIntegrationTests.cs+++ b/Aetheris.Server.Tests/KernelApiIntegrationTests.cs@@ -910,6 +910,31 @@ public sealed class KernelApiIntegrationTests : IClassFixture<WebApplicationFactAssert.True(Guid.TryParse(loaded.Data.BodyId, out _));}+ [Fact]+ public async Task CadmataProjectedPmiFixture_PublishesConstraintProvenanceAndFaceOwnership()+ {+ var document = await CreateDocumentAsync("/api/v1/documents");+ var response = await _client.PostAsync($"/api/v1/documents/{document.Data!.DocumentId}/cadmata/fixtures/pmi-projected-hole-diameter", null);+ response.EnsureSuccessStatusCode();+ var loaded = await response.Content.ReadFromJsonAsync<ApiResponseDto<CadmataFixtureLoadResponseDto>>();+ Assert.True(loaded!.Success);+ var entities = loaded.Data!.Visualization.Entities;+ var hole = Assert.Single(entities, entity => entity.Kind == "HoleFeature");+ Assert.NotEmpty(hole.Topology!.FaceIds!);+ Assert.All(hole.Topology.FaceIds!, faceId => Assert.Contains(entities, entity => entity.Kind == "BRepFace" && entity.Topology!.FaceIds!.Contains(faceId) && entity.ParentIds!.Contains(hole.StableId)));+ Assert.Equal(loaded.Data.Visualization.Metrics["faceCount"], entities.Count(entity => entity.Kind == "BRepFace"));+ var datum = Assert.Single(entities, entity => entity.Kind == "Datum");+ Assert.Equal("A", datum.Label);+ var pmi = Assert.Single(entities, entity => entity.Kind == "HoleDiameter");+ Assert.Equal(hole.StableId, pmi.Metadata!["targetSemanticId"]);+ Assert.Equal("MountDiameterConstraint", pmi.Metadata["require"]);+ Assert.Equal("Mount.Diameter", pmi.Metadata["subject"]);+ Assert.Contains("8", pmi.Metadata["nominal"]);+ Assert.Contains("0.05", pmi.Metadata["tolerancePlus"]);+ Assert.Contains("0.02", pmi.Metadata["toleranceMinus"]);+ Assert.Equal("A", pmi.Metadata["datumRefs"]);+ }+private static string GetRepositoryPath(string relativePath)=> Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, "..", "..", "..", "..", relativePath));diff --git a/Aetheris.Server/Api/CadmataFixtureService.cs b/Aetheris.Server/Api/CadmataFixtureService.csindex cfedc2b6..dcddfc9d 100644--- a/Aetheris.Server/Api/CadmataFixtureService.cs+++ b/Aetheris.Server/Api/CadmataFixtureService.cs@@ -1,6 +1,10 @@using Aetheris.Kernel.Core.Brep;+using Aetheris.Kernel.Core.Geometry.Surfaces;+using Aetheris.Kernel.Core.Geometry;+using Aetheris.Kernel.Core.Step242;using Aetheris.Kernel.Firmament.FirmamentV2;using Aetheris.Kernel.Firmament.Materializer;+using Aetheris.Kernel.Firmament;using Aetheris.Server.Contracts;using Aetheris.Server.Documents;@@ -20,6 +24,8 @@ internal static class CadmataFixtureService["ctc-01-x3"] = "testdata/firmament/reconstructions/nist_ctc_01/ctc01_prismatic_blockout_x3.firmament",["ctc-01-x4"] = "testdata/firmament/reconstructions/nist_ctc_01/ctc01_prismatic_blockout_x4.firmament",["semantic-capsule-slot"] = "fixtures/FirmamentV2/ProfileComposition/valid/semantic-capsule-slot-through.firmament",+ ["profile-compose-l-bracket-counterbore-pmi"] = "fixtures/FirmamentV2/Canonical/valid/profile-compose-l-bracket-counterbore-pmi.firmament",+ ["pmi-projected-hole-diameter"] = "fixtures/FirmamentV2/Canonical/valid/pmi-projected-hole-diameter.firmament",};public static bool TryLoad(string fixtureId, DocumentSession document, out CadmataFixtureLoadResponseDto? response, out string error)@@ -29,6 +35,8 @@ internal static class CadmataFixtureServicevar sourcePath = Path.Combine(FindRepositoryRoot(), relative);if (!File.Exists(sourcePath)) { error = $"Cadmata fixture source is unavailable: {relative}."; return false; }var source = File.ReadAllText(sourcePath);+ if (fixtureId == "pmi-projected-hole-diameter")+ return TryLoadProjectedPmiFixture(fixtureId, relative, sourcePath, source, document, out response, out error);BrepBody? body = null; SemanticTopologyCorrespondence? correspondence = null; IReadOnlyList<ResolvedProfile2D> profiles = []; IReadOnlyList<PrismaticShaftHoleFeature> shaftHoles = []; IReadOnlyList<PrismaticCapsuleSlotFeature> capsuleSlots = []; IReadOnlyList<PrismaticRoundedRectangleSlotFeature> roundedRectangleSlots = [];var diagnostics = new List<string>(); SemanticHoleSourceInspectionEvidence? semanticHoleEvidence = null;if (fixtureId is "semantic-shaft-hole" or "construction-plane-through-hole" or "construction-plane-blind-drillpoint")@@ -61,12 +69,79 @@ internal static class CadmataFixtureService}if (body is null) { error = "The compiler did not materialize a body for this Cadmata fixture."; return false; }var added = document.AddBody(body, $"Cadmata: {fixtureId}");- var artifact = BuildArtifact(fixtureId, relative, profiles, shaftHoles, capsuleSlots, roundedRectangleSlots, correspondence, diagnostics, body, semanticHoleEvidence);+ var pmi = FirmamentV2Parser.Parse(source, Path.GetDirectoryName(sourcePath)).Document?.BoundPmi;+ var artifact = BuildArtifact(fixtureId, relative, profiles, shaftHoles, capsuleSlots, roundedRectangleSlots, correspondence, diagnostics, body, semanticHoleEvidence, pmi);response = new(document.Id.ToString(), added.OccurrenceId.ToString(), added.DefinitionId.ToString(), fixtureId, artifact);return true;}- private static CadmataVisualizationArtifactDto BuildArtifact(string fixtureId, string sourcePath, IReadOnlyList<ResolvedProfile2D> profiles, IReadOnlyList<PrismaticShaftHoleFeature> shaftHoles, IReadOnlyList<PrismaticCapsuleSlotFeature> capsuleSlots, IReadOnlyList<PrismaticRoundedRectangleSlotFeature> roundedRectangleSlots, SemanticTopologyCorrespondence? correspondence, IReadOnlyList<string> diagnostics, BrepBody body, SemanticHoleSourceInspectionEvidence? semanticHoleEvidence = null)+ private static bool TryLoadProjectedPmiFixture(string fixtureId, string sourcePath, string fullSourcePath, string source, DocumentSession document, out CadmataFixtureLoadResponseDto? response, out string error)+ {+ response = null; error = string.Empty;+ var parsed = FirmamentV2Parser.Parse(source, Path.GetDirectoryName(fullSourcePath));+ if (!parsed.IsSuccess || parsed.Document is null) { error = string.Join("; ", parsed.Diagnostics); return false; }+ var output = Path.Combine(Path.GetTempPath(), $"aetheris-cadmata-{Guid.NewGuid():N}.step");+ try+ {+ var built = FirmamentBuildAndExport.Run(fullSourcePath, output);+ if (!built.IsSuccess || built.Value is null) { error = string.Join("; ", built.Diagnostics.Select(item => item.Message)); return false; }+ var imported = Step242Importer.ImportBody(built.Value.Export.StepText);+ if (!imported.IsSuccess || imported.Value is null) { error = string.Join("; ", imported.Diagnostics.Select(item => item.Message)); return false; }+ var body = imported.Value;+ var feature = built.Value.Export.Features?.Single(item => item.Name == "Mount");+ if (feature is null) { error = "Projected PMI fixture did not publish its Mount semantic feature report."; return false; }+ var added = document.AddBody(body, $"Cadmata: {fixtureId}");+ var artifact = BuildProjectedPmiArtifact(fixtureId, sourcePath, parsed.Document, body, feature);+ response = new(document.Id.ToString(), added.OccurrenceId.ToString(), added.DefinitionId.ToString(), fixtureId, artifact);+ return true;+ }+ finally { if (File.Exists(output)) File.Delete(output); }+ }++ private static CadmataVisualizationArtifactDto BuildProjectedPmiArtifact(string fixtureId, string sourcePath, FirmamentV2Document document, BrepBody body, FirmamentHoleFeatureReport feature)+ {+ var entities = new List<CadmataVisualizationEntityDto>();+ var bodyId = $"body:{document.ModelName}.Base";+ var holeId = $"hole:{feature.FeatureId}";+ var radius = feature.Diameter / 2d;+ var center = feature.ResolvedPoint3 is { Count: 3 } point ? new CadmataPointDto(point[0], point[1], point[2]) : new(feature.LocalU, feature.LocalV, 6d);+ var holeFaces = body.Topology.Faces.Where(face => body.TryGetFaceSurfaceGeometry(face.Id, out var surface) && surface?.Kind == SurfaceGeometryKind.Cylinder && surface.Cylinder is { } cylinder && Math.Abs(cylinder.Radius - radius) < 1e-7).Select(face => face.Id.Value).Order().ToArray();+ var topFaces = body.Topology.Faces.Where(face => body.TryGetFaceSurfaceGeometry(face.Id, out var surface) && surface?.Kind == SurfaceGeometryKind.Plane && surface.Plane is { } plane && plane.Normal.ToVector().Z > 0.999).Select(face => face.Id.Value).Order().ToArray();+ var sourceSpan = feature.SourceSpan;+ entities.Add(new(bodyId, "Body", "Base", "material", "Body", null, null, null, [holeId], null, null, new(topFaces.Concat(holeFaces).Distinct().ToArray()), null, null, null, new Dictionary<string, string> { ["model"] = document.ModelName }));+ entities.Add(new(holeId, "HoleFeature", feature.Name, "conceptAxes", "SemanticHole", new("circle", Center: center, Radius: radius), sourceSpan, [bodyId], null, null, null, new(holeFaces), null, feature.MaterializationRoute, null, new Dictionary<string, string> { ["kind"] = "Hole<Shaft>", ["diameter"] = $"{feature.Diameter:R} mm", ["endCondition"] = "ThroughAll", ["sourceIdentity"] = feature.FeatureId }));+ foreach (var face in body.Topology.Faces.OrderBy(item => item.Id.Value))+ {+ var faceId = face.Id.Value;+ var isHoleFace = holeFaces.Contains(faceId);+ entities.Add(new($"brep:face:{faceId}", "BRepFace", $"Face {faceId}", "selections", isHoleFace ? "HoleShaftWall" : topFaces.Contains(faceId) ? "TopDatumRegion" : "BodyFace", null, null, [isHoleFace ? holeId : bodyId], null, null, null, new([faceId]), null, null, null, null));+ }++ var records = document.PmiBlock?.Records ?? [];+ var bound = (document.BoundPmi?.Datums ?? []).Concat(document.BoundPmi?.Dimensions ?? []).ToDictionary(item => item.Name, StringComparer.Ordinal);+ foreach (var record in records.Where(item => item.Kind is FirmamentV2PmiKind.DatumPlane or FirmamentV2PmiKind.HoleDiameter))+ {+ if (!bound.TryGetValue(record.Name, out var item)) continue;+ var isDatum = record.Kind == FirmamentV2PmiKind.DatumPlane;+ var id = isDatum ? $"pmi:datum:{record.Name}" : $"pmi:dimension:{record.Name}";+ var constraint = record.Projection is null ? null : (document.StaticAuthoring?.SemanticConstraints ?? []).SingleOrDefault(value => value.Id == record.Projection.SourceRequireId);+ var require = constraint is null ? null : document.StaticAuthoring?.Requires.SingleOrDefault(value => value.Name == constraint.Id);+ var tolerance = item.DimensionTolerance;+ var targetId = isDatum ? bodyId : holeId;+ var metadata = new Dictionary<string, string> {+ ["target"] = string.Join(", ", item.Targets), ["targetSemanticId"] = targetId,+ ["nominal"] = item.DimensionValue is { } nominal ? $"{nominal.NumericValue:R} {nominal.Unit}" : "",+ ["tolerancePlus"] = tolerance?.Plus is { } plus ? $"{plus:R} mm" : "", ["toleranceMinus"] = tolerance?.Minus is { } minus ? $"{minus:R} mm" : "",+ ["datumRefs"] = string.Join(", ", item.DatumRefs), ["projection"] = item.ProjectionSource ?? "manual",+ ["require"] = constraint?.Id ?? "", ["subject"] = constraint is null ? "" : $"{constraint.Subject}.{constraint.Property}",+ ["expected"] = require?.Expected ?? "", ["expectedProvenance"] = constraint?.ExpectedProvenance ?? require?.Provenance ?? "", ["toleranceSource"] = require?.ToleranceSource ?? ""+ };+ entities.Add(new(id, isDatum ? "Datum" : "HoleDiameter", record.Name, isDatum ? "conceptPlanes" : "conceptPoints", isDatum ? "Datum" : "HoleDiameter", new("circle", Center: center, Radius: isDatum ? radius * 1.5 : radius), record.SourceSpan.ToString(), [targetId], null, null, null, new(isDatum ? topFaces : holeFaces), null, null, null, metadata));+ }+ return new("cadmata-concept-viz-x1", fixtureId, sourcePath, entities, [], [], new Dictionary<string, double> { ["entityCount"] = entities.Count, ["faceCount"] = body.Topology.Faces.Count(), ["pmiCount"] = entities.Count(item => item.Kind is "Datum" or "HoleDiameter") });+ }++ private static CadmataVisualizationArtifactDto BuildArtifact(string fixtureId, string sourcePath, IReadOnlyList<ResolvedProfile2D> profiles, IReadOnlyList<PrismaticShaftHoleFeature> shaftHoles, IReadOnlyList<PrismaticCapsuleSlotFeature> capsuleSlots, IReadOnlyList<PrismaticRoundedRectangleSlotFeature> roundedRectangleSlots, SemanticTopologyCorrespondence? correspondence, IReadOnlyList<string> diagnostics, BrepBody body, SemanticHoleSourceInspectionEvidence? semanticHoleEvidence = null, FirmamentV2BoundPmiBlock? pmi = null){var entities = new List<CadmataVisualizationEntityDto>();foreach (var profile in profiles)@@ -147,6 +222,20 @@ internal static class CadmataFixtureService{entities.Add(new(descendant.StableId, $"BRep{descendant.Kind}", descendant.Role.ToString(), descendant.Kind == "Face" ? "selections" : "brepEdges", descendant.Role.ToString(), null, null, [descendant.SourceStableId], null, null, null, new(descendant.Face is { } face ? [face.Value] : null, descendant.Edge is { } edge ? [edge.Value] : null, descendant.Loop is { } loop ? [loop.Value] : null, descendant.Vertex is { } vertex ? [vertex.Value] : null), null, null, null, null));}+ // PMI is published as an inspectable semantic entity, not a renderer-specific decoration.+ // This fixture's counterbore mouth is part of its authored source and provides a stable initial anchor.+ if (fixtureId == "profile-compose-l-bracket-counterbore-pmi" && pmi is not null)+ {+ var anchor = new CadmataGeometryDto("circle", Center: new(-30, -10, 12), Radius: 4);+ foreach (var datum in pmi.Datums)+ entities.Add(new($"pmi:datum:{datum.Name}", "Datum", datum.Name, "conceptPlanes", "Datum", anchor, datum.SourceSpan.ToString(), null, null, null, null, null, null, null, null, new Dictionary<string, string> { ["target"] = string.Join(", ", datum.Targets), ["pmiKind"] = "Datum" }));+ foreach (var dimension in pmi.Dimensions.Where(item => item.Kind == FirmamentV2PmiKind.HoleDiameter))+ {+ var tolerance = dimension.DimensionTolerance;+ entities.Add(new($"pmi:dimension:{dimension.Name}", "HoleDiameter", dimension.Name, "conceptPoints", "HoleDiameter", anchor, dimension.SourceSpan.ToString(), null, null, null, null, null, null, null, null, new Dictionary<string, string> {+ ["target"] = string.Join(", ", dimension.Targets), ["nominal"] = $"{dimension.DimensionValue?.NumericValue:R} mm", ["tolerancePlus"] = tolerance?.Plus is { } plus ? $"{plus:R} mm" : "", ["toleranceMinus"] = tolerance?.Minus is { } minus ? $"{minus:R} mm" : "", ["datumRefs"] = string.Join(", ", dimension.DatumRefs), ["projection"] = dimension.ProjectionSource ?? "manual" }));+ }+ }var hasSemanticFeatures = fixtureId is "semantic-shaft-hole" or "construction-plane-through-hole" or "construction-plane-blind-drillpoint" || shaftHoles.Count > 0 || capsuleSlots.Count > 0 || roundedRectangleSlots.Count > 0;var selectionSourceIds = fixtureId == "semantic-shaft-hole" ? new[] { "hole:base.mount" } : (fixtureId is "construction-plane-through-hole" or "construction-plane-blind-drillpoint") && semanticHoleEvidence is not null ? new[] { "hole:" + semanticHoleEvidence.FeatureId } : capsuleSlots.Count > 0 ? capsuleSlots.Select(slot => slot.StableId).ToArray() : roundedRectangleSlots.Count > 0 ? roundedRectangleSlots.Select(slot => slot.StableId).ToArray() : shaftHoles.Count > 0 ? shaftHoles.Select(hole => hole.StableId).ToArray() : entities.Where(e => e.Kind == "ProfileSegment").Select(e => e.StableId).ToArray();var selection = new CadmataVisualizationSelectionDto($"selection:{fixtureId}", hasSemanticFeatures ? "semantic feature descendants" : "compiler-published profile boundary", hasSemanticFeatures ? "FaceSet" : "LoopSet", selectionSourceIds, selectionSourceIds, !hasSemanticFeatures, []);diff --git a/aetheris.client/eslint.config.js b/aetheris.client/eslint.config.jsindex 1abf82ea..2c6e03b8 100644--- a/aetheris.client/eslint.config.js+++ b/aetheris.client/eslint.config.js@@ -6,7 +6,7 @@ import tseslint from "typescript-eslint";import { defineConfig, globalIgnores } from "eslint/config";export default defineConfig([- globalIgnores(["dist"]),+ globalIgnores(["dist", ".tspack", "obj", "node_modules"]),{files: ["**/*.{ts,tsx}"],extends: [diff --git a/aetheris.client/manifest.tsx b/aetheris.client/manifest.tsxindex 6824ea70..2cebdfd0 100644--- a/aetheris.client/manifest.tsx+++ b/aetheris.client/manifest.tsx@@ -1,3 +1,4 @@+/* eslint-disable react-refresh/only-export-components -- TSPack manifests export a declarative workspace value, not a React component. */import {CompatFiles,JsonFile,diff --git a/aetheris.client/src/App.css b/aetheris.client/src/App.cssindex e4639067..bb3ef18a 100644--- a/aetheris.client/src/App.css+++ b/aetheris.client/src/App.css@@ -478,6 +478,13 @@ strong {vertical-align: top;}+.semantic-tree { max-height: 300px; overflow: auto; border: 1px solid color-mix(in srgb, var(--shell-border) 60%, transparent); padding: 4px; }+.semantic-tree ul { list-style: none; padding-left: 0; margin: 0; }+.semantic-tree__item { width: 100%; min-height: 28px; text-align: left; border: 0; background: transparent; font-size: var(--ui-small); }+.semantic-provenance { margin-top: 8px !important; padding: 7px; border-left: 2px solid var(--shell-accent); background: color-mix(in srgb, var(--shell-panel) 75%, transparent); font-size: var(--ui-small); }+.pmi-callout { display: grid; gap: 2px; min-width: 66px; padding: 4px 7px; border: 1px solid; border-radius: 3px; box-shadow: 0 2px 8px rgb(0 0 0 / 35%); font-family: Inter, ui-sans-serif, system-ui, sans-serif; font-size: 13px; line-height: 1.1; white-space: nowrap; cursor: pointer; }+.pmi-callout small { font-size: 10px; opacity: .85; }+.property-table th {width: 46%;color: var(--shell-text-secondary);diff --git a/aetheris.client/src/App.tsx b/aetheris.client/src/App.tsxindex b3e48d22..b613c81e 100644--- a/aetheris.client/src/App.tsx+++ b/aetheris.client/src/App.tsx@@ -23,6 +23,7 @@ import {} from "./api/aetherisApi";import { StepImportDropzone } from "./components/StepImportDropzone";import { PropertyTable, type PropertyRecord } from "./components/PropertyTable";+import { SemanticInspector } from "./components/SemanticInspector";import { Button } from "./components/ui/button";import { AetherisViewport } from "./viewer/AetherisViewport";import { buildDisplaySceneData } from "./viewer/displaySceneBuilder";@@ -37,6 +38,7 @@ import {resolveCadmataSelection,type CadmataVisualizationArtifact,} from "./viewer/conceptVisualization";+import { resolvePublishedBrepEntity } from "./viewer/semanticInspection";import { documentMachine, documentPhase } from "./application/documentMachine";import { shellThemeCssVariables } from "./theme/shellTheme";import { viewportThemeById, VIEWPORT_THEMES, type ViewportTheme } from "./viewer/viewportTheme";@@ -162,6 +164,7 @@ function App() {const [cadmataLayers, setCadmataLayers] =useState<CadmataLayerVisibility>(DEFAULT_CADMATA_LAYERS);const [selectedCadmataId, setSelectedCadmataId] = useState<string | null>(null);+ const [isPmiVisible, setIsPmiVisible] = useState(true);const startupStepClaimed = useRef(false);const viewportTheme = useMemo(() => viewportThemeById(viewportThemeId), [viewportThemeId]);const shellThemeVariables = useMemo(() => shellThemeCssVariables() as CSSProperties, []);@@ -188,6 +191,7 @@ function App() {setDiagnostics([]);setCadmataArtifact(null);setSelectedCadmataId(null);+ setIsPmiVisible(true);setImportStatusMessage("Preparing workspace…");}, [dispatchDocumentEvent]);@@ -680,6 +684,11 @@ function App() {setPickStatus("success");setPickHits(pickResponse.hits);+ const hit = pickResponse.hits[0];+ if (hit && cadmataArtifact) {+ const published = resolvePublishedBrepEntity(cadmataArtifact, hit.entityKind, hit.entityKind === "Face" ? hit.faceId! : hit.edgeId!);+ if (published) setSelectedCadmataId(published.stableId);+ }setPickMessage(pickResponse.hits.length === 0? "No hit for current click ray."@@ -696,7 +705,7 @@ function App() {setPickHits([]);}},- [activeBodyId, documentId],+ [activeBodyId, cadmataArtifact, documentId],);const handleLoadCadmataFixture = useCallback(@@ -932,6 +941,7 @@ function App() {>SEMANTIC</button>+ <button type="button" className={isPmiVisible ? "viewport-segmented__button is-active" : "viewport-segmented__button"} onClick={() => setIsPmiVisible((value) => !value)} aria-pressed={isPmiVisible}>PMI</button><buttontype="button"className={@@ -979,6 +989,7 @@ function App() {cadmataLayers={cadmataLayers}selectedCadmataIds={cadmataSelection?.entityIds}onCadmataSelect={setSelectedCadmataId}+ showPmi={isPmiVisible}/></div></section>@@ -987,7 +998,7 @@ function App() {{activeTab === "viewer" ? (<><section className="tool-section cadmata-inspector">- <h2 className="section-title">Cadmata compiler evidence</h2>+ <h2 className="section-title">Semantic inspector</h2><div className="stack-row">{["direct-profile",@@ -996,6 +1007,8 @@ function App() {"construction-plane-blind-drillpoint","ctc-01-x3","ctc-01-x4",+ "profile-compose-l-bracket-counterbore-pmi",+ "pmi-projected-hole-diameter",].map((fixtureId) => (<Buttonkey={fixtureId}@@ -1010,6 +1023,7 @@ function App() {</div>{cadmataArtifact ? (<>+ <SemanticInspector artifact={cadmataArtifact} selectedId={selectedCadmataId} onSelect={setSelectedCadmataId} /><p><strong>{cadmataArtifact.fixtureId}</strong> ·{" "}{cadmataArtifact.metrics?.entityCount ?? 0} evidence entities@@ -1063,7 +1077,7 @@ function App() {: null}</>) : (- <p>Load a real Firmament fixture to inspect its compiler correspondence.</p>+ <SemanticInspector artifact={cadmataArtifact} selectedId={selectedCadmataId} onSelect={setSelectedCadmataId} />)}</section><section className="tool-section tool-section--import">diff --git a/aetheris.client/src/__tests__/semanticInspection.test.ts b/aetheris.client/src/__tests__/semanticInspection.test.tsnew file mode 100644index 00000000..7f961a68--- /dev/null+++ b/aetheris.client/src/__tests__/semanticInspection.test.ts@@ -0,0 +1,22 @@+import { describe, expect, it } from "vitest";+import { formatPmiLabel, indexSemanticInspection, resolvePublishedBrepEntity, semanticTree } from "../viewer/semanticInspection";+import type { CadmataVisualizationArtifact } from "../viewer/conceptVisualization";++const artifact: CadmataVisualizationArtifact = { schemaVersion: "cadmata-concept-viz-x1", fixtureId: "semantic", sourcePath: "fixture", selections: [], entities: [+ { stableId: "body", kind: "Body", label: "Bracket", layer: "material", childIds: ["hole"] },+ { stableId: "hole", kind: "HoleFeature", label: "Mount", layer: "conceptAxes", parentIds: ["body"], topology: { faceIds: [17] } },+ { stableId: "face-17", kind: "BRepFace", label: "Face 17", layer: "selections", parentIds: ["hole"], topology: { faceIds: [17] } },+ { stableId: "pmi", kind: "HoleDiameter", label: "MountDiameter", layer: "conceptPoints", geometry: { type: "circle", center: { x: 1, y: 2, z: 3 }, radius: 4 }, metadata: { targetSemanticId: "hole", nominal: "8 mm", tolerancePlus: "0.05 mm", toleranceMinus: "0.02 mm" } },+] };++describe("semantic inspection index", () => {+ it("keeps compiler-published face owners and deterministic hierarchy", () => {+ expect(indexSemanticInspection(artifact).faceOwners.get(17)?.map((entity) => entity.label)).toEqual(["Mount"]);+ expect(semanticTree(artifact)[0].children[0].entity.stableId).toBe("hole");+ expect(resolvePublishedBrepEntity(artifact, "Face", 17)?.stableId).toBe("face-17");+ expect(indexSemanticInspection(artifact).pmiByTarget.get("hole")?.[0].label).toBe("MountDiameter");+ });+ it("formats an asymmetric HoleDiameter callout", () => {+ expect(formatPmiLabel(artifact.entities[3])).toBe("⌀8 mm +0.05 mm/-0.02 mm");+ });+});diff --git a/aetheris.client/src/components/SemanticInspector.tsx b/aetheris.client/src/components/SemanticInspector.tsxnew file mode 100644index 00000000..574d25ae--- /dev/null+++ b/aetheris.client/src/components/SemanticInspector.tsx@@ -0,0 +1,24 @@+import { matchKind } from "machinalayout/match";+import type { ReactNode } from "react";+import { PropertyTable, type PropertyRecord } from "./PropertyTable";+import { indexSemanticInspection, semanticTree, type SemanticTreeNode } from "../viewer/semanticInspection";+import type { CadmataEntity, CadmataVisualizationArtifact } from "../viewer/conceptVisualization";++function TreeNode({ node, selectedId, onSelect, depth = 0 }: { node: SemanticTreeNode; selectedId: string | null; onSelect: (id: string) => void; depth?: number }) {+ return <li><button type="button" className={node.entity.stableId === selectedId ? "semantic-tree__item active-row" : "semantic-tree__item"} style={{ paddingLeft: 8 + depth * 12 }} onClick={() => onSelect(node.entity.stableId)}>{node.entity.kind.replace("Feature", "")} {node.entity.label}</button>{node.children.length ? <ul>{node.children.map((child) => <TreeNode key={child.entity.stableId} node={child} selectedId={selectedId} onSelect={onSelect} depth={depth + 1} />)}</ul> : null}</li>;+}+function rows(entity: CadmataEntity): PropertyRecord[] { return [{ property: "Kind", value: entity.kind }, { property: "Stable ID", value: entity.stableId }, ...(entity.sourceSpan ? [{ property: "Source", value: entity.sourceSpan }] : []), ...(entity.topology?.faceIds?.length ? [{ property: "Faces", value: entity.topology.faceIds.join(", ") }] : []), ...(entity.topology?.edgeIds?.length ? [{ property: "Edges", value: entity.topology.edgeIds.join(", ") }] : []), ...Object.entries(entity.metadata ?? {}).map(([property, value]) => ({ property, value: String(value) }))]; }+function PmiDetails({ entity }: { entity: CadmataEntity }) { return <><PropertyTable id={`pmi-${entity.stableId}`} rows={rows(entity)} />{entity.metadata?.require ? <p className="semantic-provenance"><strong>From:</strong> {String(entity.metadata.require)}<br /><strong>Subject:</strong> {String(entity.metadata.subject ?? "not published")}<br /><strong>Expected:</strong> {String(entity.metadata.expected ?? "not published")}</p> : null}</>; }+function BrepDetails({ entity, artifact }: { entity: CadmataEntity; artifact: CadmataVisualizationArtifact }) {+ const index = indexSemanticInspection(artifact);+ const owners = [...(entity.topology?.faceIds ?? []).flatMap((id) => index.faceOwners.get(id) ?? []), ...(entity.topology?.edgeIds ?? []).flatMap((id) => index.edgeOwners.get(id) ?? [])].filter((owner, position, all) => all.findIndex((item) => item.stableId === owner.stableId) === position);+ const pmi = owners.flatMap((owner) => index.pmiByTarget.get(owner.stableId) ?? []).filter((item, position, all) => all.findIndex((candidate) => candidate.stableId === item.stableId) === position);+ return <><PropertyTable id={`brep-${entity.stableId}`} rows={rows(entity)} /><p className="semantic-provenance"><strong>Semantic owner(s):</strong> {owners.length ? owners.map((owner) => `${owner.kind} ${owner.label}${owner.sourceSpan ? ` · ${owner.sourceSpan}` : ""}`).join("; ") : "None published"}<br /><strong>Associated PMI:</strong> {pmi.length ? pmi.map((item) => item.label).join(", ") : "None"}</p><p className="semantic-provenance">Advanced traceability: Aetheris topology IDs are shown above. STEP entity IDs are not yet published by this fixture channel.</p></>;+}+function GenericDetails({ entity }: { entity: CadmataEntity }) { return <PropertyTable id={`semantic-${entity.stableId}`} rows={rows(entity)} />; }+export function SemanticInspector({ artifact, selectedId, onSelect }: { artifact: CadmataVisualizationArtifact | null; selectedId: string | null; onSelect: (id: string) => void }) {+ if (!artifact) return <p>Load a real Firmament fixture to inspect compiler-published semantic structure.</p>;+ const entity = artifact.entities.find((candidate) => candidate.stableId === selectedId) ?? null;+ const details: ReactNode = entity ? matchKind((entity.kind.startsWith("BRep") ? { kind: "BRep" as const, entity } : entity.kind === "HoleDiameter" || entity.kind === "Datum" ? { kind: "Pmi" as const, entity } : { kind: "Generic" as const, entity }), { Pmi: ({ entity: item }) => <PmiDetails entity={item} />, BRep: ({ entity: item }) => <BrepDetails entity={item} artifact={artifact} />, Generic: ({ entity: item }) => <GenericDetails entity={item} /> }) as ReactNode : null;+ return <div className="semantic-inspector"><p><strong>{artifact.fixtureId}</strong> · {artifact.metrics?.entityCount ?? 0} published entities</p><div className="semantic-tree"><ul>{semanticTree(artifact).map((node) => <TreeNode key={node.entity.stableId} node={node} selectedId={selectedId} onSelect={onSelect} />)}</ul></div>{entity ? <div className="cadmata-inspector__details"><h3>{entity.label}</h3>{details}</div> : null}</div>;+}diff --git a/aetheris.client/src/viewer/AetherisViewport.tsx b/aetheris.client/src/viewer/AetherisViewport.tsxindex 6be4767a..e5489828 100644--- a/aetheris.client/src/viewer/AetherisViewport.tsx+++ b/aetheris.client/src/viewer/AetherisViewport.tsx@@ -1,3 +1,4 @@+/* eslint-disable react-hooks/immutability -- Three.js cameras/renderers are intentionally configured through their imperative mutable API. */import { Line, OrbitControls, Text } from "@react-three/drei";import { Canvas, useFrame, useThree } from "@react-three/fiber";import { matchKind } from "machinalayout/match";@@ -22,6 +23,7 @@ import { buildAdaptiveGridPlan, type GridBounds } from "./logarithmicGrid";import { CadmataOverlay, type CadmataLayerVisibility } from "./CadmataOverlay";import type { CadmataVisualizationArtifact } from "./conceptVisualization";import { ATELIER_VIEWPORT_THEME, type ViewportTheme } from "./viewportTheme";+import { PmiAnnotationLayer } from "./PmiAnnotationLayer";function intersectGround(origin: Vector3, direction: Vector3, y: number): Vector3 | null {if (Math.abs(direction.y) < 1e-6) return null;@@ -268,6 +270,7 @@ export interface AetherisViewportProps {cadmataLayers?: CadmataLayerVisibility;selectedCadmataIds?: Set<string>;onCadmataSelect?: (stableId: string) => void;+ showPmi?: boolean;}function FaceMesh({@@ -466,6 +469,7 @@ export function AetherisViewport({cadmataLayers,selectedCadmataIds = new Set(),onCadmataSelect = () => undefined,+ showPmi = true,}: AetherisViewportProps) {return (<Canvas@@ -567,6 +571,7 @@ export function AetherisViewport({onSelect={onCadmataSelect}/>) : null}+ <PmiAnnotationLayer artifact={cadmataArtifact} visible={showPmi} selectedIds={selectedCadmataIds} onSelect={onCadmataSelect} theme={theme} /><PickRayCapture onPickRay={onPickRay} /><OrbitControls makeDefault enablePan enableZoom /></Canvas>diff --git a/aetheris.client/src/viewer/PmiAnnotationLayer.tsx b/aetheris.client/src/viewer/PmiAnnotationLayer.tsxnew file mode 100644index 00000000..ac733541--- /dev/null+++ b/aetheris.client/src/viewer/PmiAnnotationLayer.tsx@@ -0,0 +1,25 @@+import { Html, Line } from "@react-three/drei";+import type { CadmataEntity, CadmataVisualizationArtifact } from "./conceptVisualization";+import { formatPmiLabel } from "./semanticInspection";+import type { ViewportTheme } from "./viewportTheme";++function anchor(entity: CadmataEntity): [number, number, number] | null {+ const geometry = entity.geometry;+ if (geometry?.type === "circle") return [geometry.center.x, geometry.center.y, geometry.center.z];+ if (geometry?.type === "point") return [geometry.point.x, geometry.point.y, geometry.point.z];+ if (geometry?.type === "polyline" && geometry.points.length) { const p = geometry.points[geometry.points.length - 1]; return [p.x, p.y, p.z]; }+ return null;+}++export function PmiAnnotationLayer({ artifact, visible, selectedIds, onSelect, theme }: { artifact: CadmataVisualizationArtifact | null; visible: boolean; selectedIds: Set<string>; onSelect: (id: string) => void; theme: ViewportTheme }) {+ if (!visible || !artifact) return null;+ return <group name="semantic-pmi-annotations">{artifact.entities.filter((entity) => entity.kind === "HoleDiameter" || entity.kind === "Datum").map((entity) => {+ const target = anchor(entity); if (!target) return null;+ const isDatum = entity.kind === "Datum"; const selected = selectedIds.has(entity.stableId);+ const offset: [number, number, number] = [target[0] + (isDatum ? -12 : 12), target[1] + 2.4, target[2] + 0.2];+ const color = selected ? theme.annotation.selected : isDatum ? theme.annotation.datum : theme.annotation.dimension;+ return <group key={entity.stableId}><Line points={[target, offset]} color={theme.annotation.leader} lineWidth={selected ? 2.5 : 1.3} />+ <Html position={offset} center style={{ pointerEvents: "auto" }}><button className="pmi-callout" type="button" onClick={(event) => { event.stopPropagation(); onSelect(entity.stableId); }} style={{ color, background: theme.annotation.background, borderColor: color }} aria-label={`Inspect ${entity.label}`}><span>{isDatum ? `DATUM ${entity.label}` : formatPmiLabel(entity)}</span>{!isDatum && entity.metadata?.datumRefs ? <small>{String(entity.metadata.datumRefs)}</small> : null}</button></Html>+ </group>;+ })}</group>;+}diff --git a/aetheris.client/src/viewer/conceptVisualization.ts b/aetheris.client/src/viewer/conceptVisualization.tsindex 40d18b47..749d180b 100644--- a/aetheris.client/src/viewer/conceptVisualization.ts+++ b/aetheris.client/src/viewer/conceptVisualization.ts@@ -121,7 +121,13 @@ export function parseCadmataVisualizationArtifact(value: unknown): CadmataVisualexport function indexCadmataArtifact(artifact: CadmataVisualizationArtifact) {const byId = new Map(artifact.entities.map((entity) => [entity.stableId, entity]));const reverse = new Map<string, Set<string>>();+ const ownedChildren = new Map<string, Set<string>>();for (const entity of artifact.entities) {+ for (const parentId of entity.parentIds ?? []) {+ const children = ownedChildren.get(parentId) ?? new Set<string>();+ children.add(entity.stableId);+ ownedChildren.set(parentId, children);+ }for (const id of [...(entity.parentIds ?? []),...(entity.childIds ?? []),@@ -133,7 +139,7 @@ export function indexCadmataArtifact(artifact: CadmataVisualizationArtifact) {reverse.set(id, related);}}- return { byId, reverse };+ return { byId, reverse, ownedChildren };}/** Traverses only compiler-published relation fields; it never tries to infer BRep correspondence in the browser. */@@ -143,7 +149,7 @@ export function resolveCadmataSelection(): CadmataSelectionState {if (!stableId)return { entityIds: new Set(), faceIds: new Set(), edgeIds: new Set(), diagnostics: [] };- const { byId, reverse } = indexCadmataArtifact(artifact);+ const { byId, ownedChildren } = indexCadmataArtifact(artifact);const pending = [stableId];const entityIds = new Set<string>();const diagnostics: CadmataDiagnostic[] = [];@@ -160,12 +166,14 @@ export function resolveCadmataSelection(continue;}entityIds.add(id);+ // A low-level pick highlights exactly the published BRep entity. Semantic+ // ownership remains inspector data and must not broaden the face highlight.+ if (entity.kind.startsWith("BRep")) continue;pending.push(- ...(entity.parentIds ?? []),...(entity.childIds ?? []),...(entity.constructionDescendantIds ?? []),...(entity.materializedDescendantIds ?? []),- ...(reverse.get(id) ?? []),+ ...(ownedChildren.get(id) ?? []),);}const faceIds = new Set<number>();diff --git a/aetheris.client/src/viewer/semanticInspection.ts b/aetheris.client/src/viewer/semanticInspection.tsnew file mode 100644index 00000000..77685329--- /dev/null+++ b/aetheris.client/src/viewer/semanticInspection.ts@@ -0,0 +1,59 @@+import type { CadmataEntity, CadmataVisualizationArtifact } from "./conceptVisualization";++export type SemanticTreeNode = { entity: CadmataEntity; children: SemanticTreeNode[] };++const KIND_ORDER = ["Body", "Profile", "Pattern", "HoleFeature", "Counterbore", "EdgeFinish", "SlotFeature", "ConstructionPlane", "Datum", "HoleDiameter", "PMI"];++/** Document-scoped index: all correspondence is published by Aetheris; no ownership is inferred here. */+export function indexSemanticInspection(artifact: CadmataVisualizationArtifact) {+ const byId = new Map(artifact.entities.map((entity) => [entity.stableId, entity]));+ const faceOwners = new Map<number, CadmataEntity[]>();+ const edgeOwners = new Map<number, CadmataEntity[]>();+ const pmiByTarget = new Map<string, CadmataEntity[]>();+ for (const entity of artifact.entities) {+ const publishedOwners = entity.kind.startsWith("BRep")+ ? (entity.parentIds ?? []).map((id) => byId.get(id)).filter((item): item is CadmataEntity => Boolean(item))+ : [entity];+ for (const faceId of entity.topology?.faceIds ?? []) {+ const owners = faceOwners.get(faceId) ?? [];+ for (const owner of publishedOwners) if (!owner.kind.startsWith("BRep") && !owners.some((item) => item.stableId === owner.stableId)) owners.push(owner);+ faceOwners.set(faceId, owners);+ }+ for (const edgeId of entity.topology?.edgeIds ?? []) {+ const owners = edgeOwners.get(edgeId) ?? [];+ for (const owner of publishedOwners) if (!owner.kind.startsWith("BRep") && !owners.some((item) => item.stableId === owner.stableId)) owners.push(owner);+ edgeOwners.set(edgeId, owners);+ }+ const target = entity.metadata?.targetSemanticId;+ if ((entity.kind === "Datum" || entity.kind === "HoleDiameter") && typeof target === "string") (pmiByTarget.get(target) ?? pmiByTarget.set(target, []).get(target)!).push(entity);+ }+ const brepFaceById = new Map(artifact.entities.flatMap((entity) => entity.kind === "BRepFace" ? (entity.topology?.faceIds ?? []).map((id) => [id, entity] as const) : []));+ const brepEdgeById = new Map(artifact.entities.flatMap((entity) => entity.kind === "BRepEdge" ? (entity.topology?.edgeIds ?? []).map((id) => [id, entity] as const) : []));+ return { byId, faceOwners, edgeOwners, pmiByTarget, brepFaceById, brepEdgeById };+}++export function resolvePublishedBrepEntity(artifact: CadmataVisualizationArtifact, kind: "Face" | "Edge", id: number) {+ const index = indexSemanticInspection(artifact);+ return kind === "Face" ? index.brepFaceById.get(id) ?? null : index.brepEdgeById.get(id) ?? null;+}++export function semanticTree(artifact: CadmataVisualizationArtifact): SemanticTreeNode[] {+ const { byId } = indexSemanticInspection(artifact);+ const children = new Map<string, CadmataEntity[]>();+ const roots: CadmataEntity[] = [];+ for (const entity of artifact.entities.filter((item) => !item.kind.startsWith("BRep"))) {+ const parent = entity.parentIds?.find((id) => byId.has(id));+ if (!parent) roots.push(entity); else (children.get(parent) ?? children.set(parent, []).get(parent)!).push(entity);+ }+ const sort = (items: CadmataEntity[]) => items.sort((a, b) => (KIND_ORDER.indexOf(a.kind) - KIND_ORDER.indexOf(b.kind)) || a.label.localeCompare(b.label));+ const build = (entity: CadmataEntity): SemanticTreeNode => ({ entity, children: sort(children.get(entity.stableId) ?? []).map(build) });+ return sort(roots).map(build);+}++export function formatPmiLabel(entity: CadmataEntity) {+ const value = entity.metadata?.nominal ?? entity.metadata?.value ?? "";+ const plus = entity.metadata?.tolerancePlus;+ const minus = entity.metadata?.toleranceMinus;+ const tolerance = plus || minus ? ` +${plus ?? "0"}/-${minus ?? "0"}` : "";+ return entity.kind === "HoleDiameter" ? `⌀${value}${tolerance}` : entity.label;+}diff --git a/aetheris.client/src/viewer/viewportTheme.ts b/aetheris.client/src/viewer/viewportTheme.tsindex 35da3f50..e185cd28 100644--- a/aetheris.client/src/viewer/viewportTheme.ts+++ b/aetheris.client/src/viewer/viewportTheme.ts@@ -34,6 +34,7 @@ export interface ViewportTheme {postProcess: { outline: boolean; colorGrade: "neutral" | "pastel" };cameraPresentation: { position: readonly [number, number, number]; zoom: number };axis: { x: string; y: string; z: string; label: string };+ annotation: { text: string; background: string; leader: string; datum: string; dimension: string; selected: string };}export const ATELIER_VIEWPORT_THEME: ViewportTheme = {@@ -72,6 +73,7 @@ export const ATELIER_VIEWPORT_THEME: ViewportTheme = {postProcess: { outline: false, colorGrade: "neutral" },cameraPresentation: { position: [6, 6, 6], zoom: 90 },axis: { x: "#a46757", y: "#6f8b64", z: "#b39b62", label: "#cbc7ba" },+ annotation: { text: "#fff9e8", background: "#1b1d1b", leader: "#e8d8a2", datum: "#8ec8d2", dimension: "#f0cf68", selected: "#ffffff" },};export const MONUMENT_VIEWPORT_THEME: ViewportTheme = {@@ -103,6 +105,7 @@ export const MONUMENT_VIEWPORT_THEME: ViewportTheme = {fog: { enabled: true, color: "#d9cfbd", near: 34, far: 115 },postProcess: { outline: false, colorGrade: "pastel" },axis: { x: "#a2535c", y: "#528378", z: "#9e7d45", label: "#5f554c" },+ annotation: { text: "#302b26", background: "#fff6df", leader: "#5d6d6c", datum: "#246e79", dimension: "#915642", selected: "#000000" },};export const VIEWPORT_THEMES = [ATELIER_VIEWPORT_THEME, MONUMENT_VIEWPORT_THEME] as const;diff --git a/docs/preview2/cadmata-semantic-inspector-m2.md b/docs/preview2/cadmata-semantic-inspector-m2.mdnew file mode 100644index 00000000..5a8f37a3--- /dev/null+++ b/docs/preview2/cadmata-semantic-inspector-m2.md@@ -0,0 +1,19 @@+# Cadmata semantic inspector M2++Cadmata’s fixture display contract remains compiler-authored: entities publish stable IDs, semantic kind/label, source span, hierarchy, topology descendants, material descendants, diagnostics, and metadata. The M2 extension treats `Datum` and `HoleDiameter` as inspectable entities rather than renderer details.++Selection is a single stable-ID state. The document-scoped semantic index builds correspondence once per artifact; semantic selections traverse only published relations and highlight BRep face/edge descendants. Geometry picking remains a BRep hit; imported STEP entity IDs are not currently in the fixture contract and are shown honestly as unavailable.++The viewport annotation layer is separate from mesh materials. It uses HTML screen-space labels plus Three leader lines, hides with standard HTML occlusion, and is controlled by the PMI toggle. Hole dimensions render `⌀nominal +plus/-minus`; datum labels render an associated leader. Annotation colors are viewport-theme tokens, independent of the warm shell theme.++The `profile-compose-l-bracket-counterbore-pmi` fixture publishes current supported Datum and HoleDiameter PMI with nominal, asymmetric tolerance, datum refs, target, and projection/manual metadata. Template instances are not yet published by the compiler fixture channel; the generic entity model can represent `TemplateInstance` once it supplies template name, instance name, parameters, and generated child IDs.++MachinaLayout is used for property tables and match-based inspector rendering; the tree/annotation DOM stays plain React because it is dynamic scene content rather than static layout.++Current limitation: AP242 imported PMI and raw STEP entity IDs are not published by the server display contract yet; M2 visualizes compiler-authored Firmament PMI only.++## Closeout++The projected `pmi-projected-hole-diameter` fixture exercises the full Static/Require chain. The server exports and reimports the real model, publishes every BRep face plus the hole-shaft ownership, and exposes `MountDiameterConstraint`, `Mount.Diameter`, nominal/tolerance, Datum A, expected value, expected provenance, and tolerance source. Viewport BRep picks resolve through the precomputed published-ID index; no browser-side geometric classification is performed.++Browser evidence is under `docs/preview2/evidence/cadmata-m2/`. Imported AP242 PMI, exhaustive STEP entity IDs, broad Pattern/EdgeFinish coverage, and TemplateInstance UI remain intentionally deferred.diff --git a/docs/preview2/evidence/cadmata-m2/01-atelier-projected-pmi.png b/docs/preview2/evidence/cadmata-m2/01-atelier-projected-pmi.pngnew file mode 100644index 00000000..0c697af5Binary files /dev/null and b/docs/preview2/evidence/cadmata-m2/01-atelier-projected-pmi.png differdiff --git a/docs/preview2/evidence/cadmata-m2/02-projected-pmi-provenance.png b/docs/preview2/evidence/cadmata-m2/02-projected-pmi-provenance.pngnew file mode 100644index 00000000..8cf751b4Binary files /dev/null and b/docs/preview2/evidence/cadmata-m2/02-projected-pmi-provenance.png differdiff --git a/docs/preview2/evidence/cadmata-m2/03-brep-face-semantic-owner.png b/docs/preview2/evidence/cadmata-m2/03-brep-face-semantic-owner.pngnew file mode 100644index 00000000..ffaec848Binary files /dev/null and b/docs/preview2/evidence/cadmata-m2/03-brep-face-semantic-owner.png differdiff --git a/docs/preview2/evidence/cadmata-m2/04-semantic-hole-highlight.png b/docs/preview2/evidence/cadmata-m2/04-semantic-hole-highlight.pngnew file mode 100644index 00000000..fd53273bBinary files /dev/null and b/docs/preview2/evidence/cadmata-m2/04-semantic-hole-highlight.png differ