Skip to content

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.cs
index 119d9f0f..2825a094 100644
--- a/Aetheris.Server.Tests/KernelApiIntegrationTests.cs
+++ b/Aetheris.Server.Tests/KernelApiIntegrationTests.cs
@@ -910,6 +910,31 @@ public sealed class KernelApiIntegrationTests : IClassFixture<WebApplicationFact
Assert.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.cs
index 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 CadmataFixtureService
var 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.js
index 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.tsx
index 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.css
index 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.tsx
index 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>
<button
type="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) => (
<Button
key={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.ts
new file mode 100644
index 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.tsx
new file mode 100644
index 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.tsx
index 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.tsx
new file mode 100644
index 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.ts
index 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): CadmataVisual
export 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.ts
new file mode 100644
index 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.ts
index 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.md
new file mode 100644
index 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.png
new file mode 100644
index 00000000..0c697af5
Binary files /dev/null and b/docs/preview2/evidence/cadmata-m2/01-atelier-projected-pmi.png differ
diff --git a/docs/preview2/evidence/cadmata-m2/02-projected-pmi-provenance.png b/docs/preview2/evidence/cadmata-m2/02-projected-pmi-provenance.png
new file mode 100644
index 00000000..8cf751b4
Binary files /dev/null and b/docs/preview2/evidence/cadmata-m2/02-projected-pmi-provenance.png differ
diff --git a/docs/preview2/evidence/cadmata-m2/03-brep-face-semantic-owner.png b/docs/preview2/evidence/cadmata-m2/03-brep-face-semantic-owner.png
new file mode 100644
index 00000000..ffaec848
Binary files /dev/null and b/docs/preview2/evidence/cadmata-m2/03-brep-face-semantic-owner.png differ
diff --git a/docs/preview2/evidence/cadmata-m2/04-semantic-hole-highlight.png b/docs/preview2/evidence/cadmata-m2/04-semantic-hole-highlight.png
new file mode 100644
index 00000000..fd53273b
Binary files /dev/null and b/docs/preview2/evidence/cadmata-m2/04-semantic-hole-highlight.png differ