from __future__ import annotations import hashlib import importlib.util import json import math import sys import tempfile import unittest from copy import deepcopy from pathlib import Path ROOT = Path(__file__).resolve().parents[2] sys.path.insert(0, str(ROOT / "backend" / "engine")) from cdsl_engine.batch_rebuild import _failure_category, _verification_classification, batch_analyze # noqa: E402 from cdsl_engine.capabilities import CapabilityAnalyzer # noqa: E402 from cdsl_engine.runtime_types import ( # noqa: E402 BendSpec, HoleSpec, PlaneSpec, TopologyDelta, TopologyDeltaRelation, TopologyRecord, TopologyRegistry, ) from cdsl_engine.sketch_solver import SHAPE_GENERATORS, resolve_all_sketches # noqa: E402 def _workplane() -> dict: return {"origin_mm": [0, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 0, 1]} def _rectangle(minimum: list[float], maximum: list[float]) -> dict: return {"type": "polygon", "vertices": [ [minimum[0], minimum[1]], [maximum[0], minimum[1]], [maximum[0], maximum[1]], [minimum[0], maximum[1]], ]} def _two_body_boolean_cdsl(operation: str, left: dict, right: dict) -> dict: return { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": f"boolean-{operation}", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "left", "workplane": _workplane(), "profile": left}, {"id": "right", "workplane": _workplane(), "profile": right}, ]}, "features": [ { "id": "left_body", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "left", "params": {"distance_mm": 4, "result_mode": "new_body"}, }, { "id": "right_body", "atomic_id": "extrude_add_blind", "depends_on": ["left_body"], "sketch_id": "right", "params": {"distance_mm": 4, "result_mode": "new_body"}, }, { "id": "boolean", "atomic_id": "boolean_bodies", "depends_on": ["left_body", "right_body"], "params": { "operation": operation, "target_feature_ids": ["left_body"], "tool_feature_ids": ["right_body"], "keep_tools": False, }, }, ], } def _selector_digest(selectors: list[str]) -> str: return hashlib.sha256("\n".join(selectors).encode("utf-8")).hexdigest() def _corpus_manifest(source: Path) -> dict: return json.loads((source / "corpus-manifest.json").read_text(encoding="utf-8")) class EngineRuntimeFoundationTests(unittest.TestCase): def _base_block(self) -> dict: return { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "runtime-block", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "base", "workplane": _workplane(), "profile": _rectangle([-5, -5], [5, 5]), }]}, "features": [{ "id": "base_add", "atomic_id": "extrude_add_blind", "depends_on": [], "params": {"distance_mm": 10}, "sketch_id": "base", }], } def test_planar_face_workplane_projects_the_global_origin_to_the_support_plane(self) -> None: from build123d import Edge, Face, Plane, Wire from cdsl_engine.build123d_adapter import Build123dGeometryAdapter plane = Plane((10, 20, 30), (1, 0, 0), (0, 0, 1)) corners = [ plane.origin + plane.x_dir * x + plane.y_dir * y for x, y in ((-5, -10), (5, -10), (5, 10), (-5, 10)) ] face = Face(Wire([ Edge.make_line(corners[index], corners[(index + 1) % len(corners)]) for index in range(len(corners)) ])) workplane = Build123dGeometryAdapter.planar_face_workplane(face) self.assertAlmostEqual(workplane.origin_mm[0], 0.0, places=7) self.assertAlmostEqual(workplane.origin_mm[1], 0.0, places=7) self.assertAlmostEqual(workplane.origin_mm[2], 30.0, places=7) self.assertEqual(workplane.normal, (0.0, 0.0, 1.0)) def test_runtime_module_has_no_build123d_import(self) -> None: runtime_source = (ROOT / "backend" / "engine" / "cdsl_engine" / "runtime.py").read_text(encoding="utf-8") self.assertNotIn("from build123d", runtime_source) self.assertNotIn("import build123d", runtime_source) def test_execution_session_declares_a_kernel_neutral_adapter_protocol(self) -> None: from cdsl_engine.runtime import ExecutionSession, GeometryAdapter self.assertIn("adapter", ExecutionSession.__dataclass_fields__) self.assertTrue(getattr(GeometryAdapter, "_is_protocol", False)) self.assertIn("export", GeometryAdapter.__dict__) def test_missing_bend_generator_does_not_block_engine_import(self) -> None: if importlib.util.find_spec("cdsl_engine.parametric_bend") is not None: self.skipTest("bend generator is installed") from cdsl_engine.build123d_adapter import Build123dGeometryAdapter from cdsl_engine.runtime import rebuild_cdsl self.assertTrue(callable(rebuild_cdsl)) spec = BendSpec.from_feature({ "thickness_mm": 1, "width_mm": 10, "chain": [{"leg_mm": 10}], }) with self.assertRaisesRegex(RuntimeError, "bend_add requires cdsl_engine.parametric_bend.build_bend_solid"): Build123dGeometryAdapter.bend_solid(spec) def test_hole_spec_normalizes_wizard_subtypes_without_occ_dependencies(self) -> None: spec = HoleSpec.from_feature("hole_wizard", { "diameter_mm": 2, "depth_mm": 6, "end_condition": {"type": "blind", "solidworks_code": 0}, "positions": [{"mm": [1, 2, 3]}], "countersink": {"diameter_mm": 4, "angle_rad": 1.5707963267948966}, }, wizard=True) self.assertEqual(spec.positions_mm, ((1.0, 2.0, 3.0),)) self.assertEqual(spec.countersink, (4.0, 1.5707963267948966)) with self.assertRaisesRegex(ValueError, "larger than the main hole"): HoleSpec.from_feature("hole_wizard", { "diameter_mm": 2, "depth_mm": 6, "end_condition": {"type": "blind", "solidworks_code": 0}, "positions": [{"mm": [0, 0, 0]}], "counterbore": {"diameter_mm": 2, "depth_mm": 1}, }, wizard=True) def test_analytic_contours_create_a_region_with_hole(self) -> None: cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "two-point-spline", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "sketch", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [ {"role": "outer", "closed": True, "segments": [ {"type": "line", "start": [0, 0], "end": [10, 0]}, {"type": "line", "start": [10, 0], "end": [10, 10]}, {"type": "line", "start": [10, 10], "end": [0, 10]}, {"type": "line", "start": [0, 10], "end": [0, 0]}, ]}, {"role": "inner", "closed": True, "segments": [ {"type": "circle", "center": [5, 5], "radius_mm": 2}, ]}, ]}, }]}, "features": [{ "id": "two_point_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "two-point-spline", "params": {"distance_mm": 1}, }], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] region = sketch["contour_regions_mm"][0] self.assertEqual(len(region["outer"]), 4) self.assertEqual(len(region["holes"]), 1) self.assertEqual(len(region["holes"][0]), 4) def test_analytic_contours_normalize_disjoint_inner_roles(self) -> None: cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{ "id": "sketch", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [ {"role": "outer", "closed": True, "segments": [ {"type": "line", "start": [0, 0], "end": [2, 0]}, {"type": "line", "start": [2, 0], "end": [2, 2]}, {"type": "line", "start": [2, 2], "end": [0, 2]}, {"type": "line", "start": [0, 2], "end": [0, 0]}, ]}, {"role": "inner", "closed": True, "segments": [ {"type": "line", "start": [4, 0], "end": [6, 0]}, {"type": "line", "start": [6, 0], "end": [6, 2]}, {"type": "line", "start": [6, 2], "end": [4, 2]}, {"type": "line", "start": [4, 2], "end": [4, 0]}, ]}, ]}, }]}, "features": [], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] self.assertEqual(len(sketch["contour_regions_mm"]), 2) self.assertTrue(all(not region["holes"] for region in sketch["contour_regions_mm"])) def test_analytic_contours_do_not_turn_shared_boundaries_into_holes(self) -> None: """A touching contour is an independent region, never a hole loop.""" cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{ "id": "sketch", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [ {"role": "unknown", "closed": True, "segments": [ {"type": "line", "start": [0, 0], "end": [2, 0]}, {"type": "line", "start": [2, 0], "end": [1, 1]}, {"type": "line", "start": [1, 1], "end": [0, 0]}, ]}, {"role": "unknown", "closed": True, "segments": [ {"type": "line", "start": [0, 0], "end": [1, 1]}, {"type": "line", "start": [1, 1], "end": [-1, 1]}, {"type": "line", "start": [-1, 1], "end": [0, 0]}, ]}, ]}, }]}, "features": [], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] self.assertEqual(len(sketch["contour_regions_mm"]), 2) self.assertTrue(all(not region["holes"] for region in sketch["contour_regions_mm"])) from cdsl_engine.build123d_adapter import Build123dGeometryAdapter faces = Build123dGeometryAdapter().faces_for_sketch(sketch) self.assertEqual(len(faces), 2) self.assertTrue(all(len(face.faces()) == 1 for face in faces)) def test_analytic_circle_contours_preserve_single_circular_wire_edges(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{ "id": "sketch", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [ {"role": "outer", "closed": True, "segments": [ {"type": "circle", "center": [-10, 0], "radius_mm": 2}, ]}, {"role": "outer", "closed": True, "segments": [ {"type": "circle", "center": [10, 0], "radius_mm": 2}, ]}, ]}, }]}, "features": [], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] faces = Build123dGeometryAdapter().faces_for_sketch(sketch) self.assertEqual(len(faces), 2) self.assertTrue(all(len(face.outer_wire().edges()) == 1 for face in faces)) def test_multi_source_regions_keep_nested_sources_as_independent_union_regions(self) -> None: """A nested qSketchRegion source is not a hole in its sibling source.""" from cdsl_engine.build123d_adapter import Build123dGeometryAdapter from cdsl_engine.runtime import rebuild_cdsl from cdsl_engine.semantic_validation import validate_semantic_cdsl profile = { "type": "multi_source_regions", "source_sketch_ids": ["outer_source", "inner_source"], "profiles": [ {"type": "circle", "center": [0, 0], "radius_mm": 5}, {"type": "circle", "center": [0, 0], "radius_mm": 2}, ], } cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "multi-source-regions", "meta": {"unit": "mm"}, "geometry": {"sketches": [{"id": "regions", "workplane": _workplane(), "profile": profile}]}, "features": [{ "id": "regions_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "regions", "params": {"distance_mm": 2}, "execution_status": "supported", }], } validate_semantic_cdsl(cdsl) sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] self.assertEqual(len(sketch["contour_regions_mm"]), 2) self.assertTrue(all(not region["holes"] for region in sketch["contour_regions_mm"])) self.assertEqual(len(Build123dGeometryAdapter().faces_for_sketch(sketch)), 2) with tempfile.TemporaryDirectory() as directory: rebuilt = rebuild_cdsl(cdsl, Path(directory) / "multi-source-regions.step") self.assertEqual(rebuilt["solid_count"], 1) self.assertAlmostEqual(rebuilt["volume_mm3"], math.pi * 5 ** 2 * 2, places=5) malformed = json.loads(json.dumps(cdsl)) malformed["geometry"]["sketches"][0]["profile"]["source_sketch_ids"].append("third_source") with self.assertRaisesRegex(ValueError, "one unique source id per profile"): validate_semantic_cdsl(malformed) def test_planar_imprint_selects_an_exact_bounded_split_region(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter from cdsl_engine.runtime import rebuild_cdsl from cdsl_engine.semantic_validation import validate_semantic_cdsl def line(identifier: str, start: list[float], end: list[float]) -> dict: return {"id": identifier, "curve": {"type": "line", "start": start, "end": end}} profile = { "type": "planar_imprint", "source_entities": [ line("bottom", [-5, -5], [5, -5]), line("right", [5, -5], [5, 5]), line("top", [5, 5], [-5, 5]), line("left", [-5, 5], [-5, -5]), line("cut", [-5, 0], [5, 0]), line("divider", [0, -5], [0, 5]), ], "selections": [{ "source_entity_id": "cut", "face_side": 1, "fragment": {"anchor_entity_id": "divider", "side": -1, "intersection_index": 0}, }], } cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "planar-imprint", "meta": {"unit": "mm"}, "geometry": {"sketches": [{"id": "imprint", "workplane": _workplane(), "profile": profile}]}, "features": [{ "id": "imprint_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "imprint", "params": {"distance_mm": 2}, "execution_status": "supported", }], } validate_semantic_cdsl(cdsl) sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] faces = Build123dGeometryAdapter().faces_for_sketch(sketch) self.assertEqual(len(faces), 1) self.assertAlmostEqual(faces[0].area, 25.0, places=6) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "imprint.step") self.assertAlmostEqual(float(result["volume_mm3"]), 50.0, places=6) def test_planar_imprint_bare_source_collects_its_bounded_split_faces(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter profile = { "type": "planar_imprint", "source_entities": [ {"id": "bottom", "curve": {"type": "line", "start": [-5, -5], "end": [5, -5]}}, {"id": "right", "curve": {"type": "line", "start": [5, -5], "end": [5, 5]}}, {"id": "top", "curve": {"type": "line", "start": [5, 5], "end": [-5, 5]}}, {"id": "left", "curve": {"type": "line", "start": [-5, 5], "end": [-5, -5]}}, {"id": "divider", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, ], "selections": [{"source_entity_id": "top", "face_side": 1}], } sketch = resolve_all_sketches({"geometry": {"sketches": [{ "id": "imprint", "workplane": _workplane(), "profile": profile, }]}})["geometry"]["sketches"][0] faces = Build123dGeometryAdapter().faces_for_sketch(sketch) self.assertEqual(len(faces), 2) self.assertAlmostEqual(sum(face.area for face in faces), 100.0, places=6) def test_planar_imprint_multiregion_extrude_registers_final_fuse_history(self) -> None: from cdsl_engine.runtime import prepare_cdsl_execution profile = { "type": "planar_imprint", "source_entities": [ {"id": "bottom", "curve": {"type": "line", "start": [-5, -5], "end": [5, -5]}}, {"id": "right", "curve": {"type": "line", "start": [5, -5], "end": [5, 5]}}, {"id": "top", "curve": {"type": "line", "start": [5, 5], "end": [-5, 5]}}, {"id": "left", "curve": {"type": "line", "start": [-5, 5], "end": [-5, -5]}}, {"id": "divider", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, ], "selections": [{"source_entity_id": "top", "face_side": 1}], } cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "planar-imprint-fuse-history", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "imprint", "source_sketch_id": "F0", "workplane": _workplane(), "profile": profile, }]}, "features": [{ "id": "f1", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "imprint", "params": {"distance_mm": 2, "result_mode": "new_body"}, }], } execution = prepare_cdsl_execution(cdsl) self.assertTrue(execution.analysis.runtime_eligible) execution.execute_all() self.assertTrue(execution.session.body.is_valid) self.assertAlmostEqual(float(execution.session.body.volume), 200.0, places=6) self.assertEqual( [(item["history_status"], item.get("history_reason")) for item in execution.session.topology.topology_deltas()], [("proven", "exact_prism_fuse_history")], ) def test_planar_imprint_preserves_a_logical_circle_source_through_a_split(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter from cdsl_engine.runtime import rebuild_cdsl profile = { "type": "planar_imprint", "source_entities": [ {"id": "circle", "curve": {"type": "circle", "center": [0, 0], "radius_mm": 10}}, {"id": "divider", "curve": {"type": "line", "start": [-10, 0], "end": [10, 0]}}, ], "selections": [{ "source_entity_id": "circle", "face_side": 1, "fragment": {"anchor_entity_id": "divider", "side": -1, "intersection_index": 0}, }], } cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "circle-imprint", "meta": {"unit": "mm"}, "geometry": {"sketches": [{"id": "imprint", "workplane": _workplane(), "profile": profile}]}, "features": [{ "id": "imprint_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "imprint", "params": {"distance_mm": 2}, "execution_status": "supported", }], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] circle = next(item for item in sketch["imprint_entities_mm"] if item["id"] == "circle") self.assertEqual([edge["type"] for edge in circle["edges"]], ["circle"]) faces = Build123dGeometryAdapter().faces_for_sketch(sketch) self.assertEqual(len(faces), 1) self.assertAlmostEqual(faces[0].area, math.pi * 50.0, places=6) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "circle-imprint.step") self.assertAlmostEqual(float(result["volume_mm3"]), math.pi * 100.0, places=6) def test_planar_imprint_rejects_a_near_miss_fragment_intersection(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter sketch = { "id": "near-miss", "workplane": _workplane(), "profile": { "type": "planar_imprint", "source_entities": [ {"id": "circle", "curve": {"type": "circle", "center": [0, 0], "radius_mm": 10}}, {"id": "nearby", "curve": {"type": "line", "start": [10.001, -5], "end": [10.001, 5]}}, ], "selections": [{ "source_entity_id": "circle", "face_side": 1, "fragment": {"anchor_entity_id": "nearby", "side": -1, "intersection_index": 0}, }], }, } resolved = resolve_all_sketches({"geometry": {"sketches": [sketch]}})["geometry"]["sketches"][0] with self.assertRaisesRegex(ValueError, "source and anchor do not intersect"): Build123dGeometryAdapter().faces_for_sketch(resolved) def test_planar_imprint_rejects_an_unbounded_arrangement_region(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter sketch = { "id": "unbounded", "workplane": _workplane(), "profile": { "type": "planar_imprint", "source_entities": [ {"id": "cut", "curve": {"type": "line", "start": [-5, 0], "end": [5, 0]}}, {"id": "divider", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, ], "selections": [{ "source_entity_id": "cut", "face_side": 1, "fragment": {"anchor_entity_id": "divider", "side": -1, "intersection_index": 0}, }], }, } resolved = resolve_all_sketches({"geometry": {"sketches": [sketch]}})["geometry"]["sketches"][0] with self.assertRaisesRegex(ValueError, "selected region is unbounded"): Build123dGeometryAdapter().faces_for_sketch(resolved) def test_planar_imprint_uses_an_exact_runtime_support_face(self) -> None: """An attached support is topology, not the artificial IMPRINT box.""" from build123d import Face, Plane from cdsl_engine.build123d_adapter import Build123dGeometryAdapter sketch = { "id": "attached-imprint", "workplane": _workplane(), "profile": { "type": "planar_imprint", "source_entities": [ {"id": "cut", "curve": {"type": "line", "start": [-5, 0], "end": [5, 0]}}, {"id": "divider", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, ], "selections": [{ "source_entity_id": "cut", "face_side": 1, "fragment": {"anchor_entity_id": "divider", "side": -1, "intersection_index": 0}, }], }, } resolved = resolve_all_sketches({"geometry": {"sketches": [sketch]}})["geometry"]["sketches"][0] support = Face.make_rect(10, 10, Plane.XY) faces = Build123dGeometryAdapter().faces_for_sketch(resolved, support_face=support) self.assertEqual(len(faces), 1) self.assertAlmostEqual(faces[0].area, 25.0, places=6) def test_planar_imprint_can_use_a_proven_external_boundary_edge_as_fragment_anchor(self) -> None: """An attached CAP edge can be a splitter witness without becoming a source curve.""" from build123d import Face, Plane from cdsl_engine.build123d_adapter import Build123dGeometryAdapter sketch = { "id": "attached-external-anchor", "source_sketch_id": "F-attached", "workplane": _workplane(), "profile": { "type": "planar_imprint", "source_entities": [ {"id": "cut", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, {"id": "top", "curve": {"type": "line", "start": [-5, 5], "end": [5, 5]}}, ], "selections": [{ "source_entity_id": "cut", "face_side": 1, "fragment": {"external_anchor_id": "cap-boundary", "side": -1}, }], }, } resolved = resolve_all_sketches({"geometry": {"sketches": [sketch]}})["geometry"]["sketches"][0] support = Face.make_rect(10, 10, Plane.XY) cap_boundary = next( edge for edge in support.edges() if abs(edge.bounding_box().min.Y + 5.0) < 1e-9 and abs(edge.bounding_box().max.Y + 5.0) < 1e-9 ) faces, anchors = Build123dGeometryAdapter().faces_for_sketch_with_source_anchors( resolved, support_face=support, external_anchor_edges={"cap-boundary": cap_boundary}, ) self.assertEqual(len(faces), 1) self.assertAlmostEqual(faces[0].area, 50.0, places=6) self.assertTrue(anchors) self.assertTrue(all(item.get("source_entity", (None,))[0] == "F-attached" for item in anchors if item["kind"] == "edge")) self.assertFalse(any(item.get("source_entity", (None, None))[1] == "cap-boundary" for item in anchors)) def test_planar_imprint_rejects_missing_or_ambiguous_external_fragment_anchor(self) -> None: """The adapter never substitutes a same-sketch curve for an external witness.""" from build123d import Face, Plane from cdsl_engine.build123d_adapter import Build123dGeometryAdapter support = Face.make_rect(10, 10, Plane.XY) base = { "id": "external-anchor-reject", "workplane": _workplane(), "profile": { "type": "planar_imprint", "source_entities": [ {"id": "cut", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, {"id": "other", "curve": {"type": "line", "start": [-5, 0], "end": [0, 0]}}, ], "selections": [{ "source_entity_id": "cut", "face_side": 1, "fragment": {"external_anchor_id": "missing", "side": -1}, }], }, } resolved = resolve_all_sketches({"geometry": {"sketches": [base]}})["geometry"]["sketches"][0] with self.assertRaisesRegex(ValueError, "fragment anchor is unavailable"): Build123dGeometryAdapter().faces_for_sketch(resolved, support_face=support) ambiguous = json.loads(json.dumps(base)) ambiguous["profile"]["selections"][0]["fragment"]["anchor_entity_id"] = "other" resolved_ambiguous = resolve_all_sketches({"geometry": {"sketches": [ambiguous]}})["geometry"]["sketches"][0] with self.assertRaisesRegex(ValueError, "exactly one anchor"): Build123dGeometryAdapter().faces_for_sketch( resolved_ambiguous, support_face=support, external_anchor_edges={"missing": support.edges()[0]}, ) def test_runtime_attachment_face_stays_session_local(self) -> None: """Attachment topology may support a splitter but cannot leak into CDSL.""" from build123d import Face, Plane from cdsl_engine.session import ExecutionSession from cdsl_engine.topology import SelectorResolution support = Face.make_rect(10, 10, Plane.XY) selector = {"kind": "face", "owner_feature_id": "base"} session = ExecutionSession( sketches={"attached": { "id": "attached", "workplane": _workplane(), "attachment": selector, "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }}, nodes={}, ) record = TopologyRecord("face:base", "face", "base", "body:base", value=support) session.resolve = lambda _selector: SelectorResolution( # type: ignore[method-assign] selector=selector, status="resolved", record=record, ) session.resolve_sketch_attachment("attached", feature_id="consumer") self.assertTrue(session.sketch_attachment_faces["attached"].wrapped.IsSame(support.wrapped)) self.assertNotIn("support_face", session.sketches["attached"]) self.assertNotIn("runtime_record", session.sketches["attached"]) def test_runtime_attachment_resolves_external_imprint_anchor_only_on_support_boundary(self) -> None: """An external fragment anchor must be a proven edge of its support face.""" from build123d import Face, Plane from cdsl_engine.session import ExecutionSession from cdsl_engine.topology import SelectorResolution support = Face.make_rect(10, 10, Plane.XY) cap_edge = next( edge for edge in support.edges() if abs(edge.bounding_box().min.Y + 5.0) < 1e-9 and abs(edge.bounding_box().max.Y + 5.0) < 1e-9 ) sketch = { "id": "attached-imprint", "workplane": _workplane(), "attachment": {"kind": "face", "tag": "support"}, "profile": { "type": "planar_imprint", "source_entities": [ {"id": "cut", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, {"id": "top", "curve": {"type": "line", "start": [-5, 5], "end": [5, 5]}}, ], "external_anchors": [{"id": "cap", "selector": {"kind": "edge", "tag": "cap"}}], "selections": [{ "source_entity_id": "cut", "face_side": 1, "fragment": {"external_anchor_id": "cap", "side": -1}, }], }, } session = ExecutionSession(sketches={"attached-imprint": sketch}, nodes={}) support_record = TopologyRecord("face:base", "face", "base", "body:base", value=support) edge_record = TopologyRecord("edge:base", "edge", "base", "body:base", value=cap_edge) session.resolve = lambda selector: SelectorResolution( # type: ignore[method-assign] selector=selector, status="resolved", record=support_record if selector.get("tag") == "support" else edge_record, ) session.resolve_sketch_attachment("attached-imprint", feature_id="consumer") self.assertTrue(session.sketch_attachment_faces["attached-imprint"].wrapped.IsSame(support.wrapped)) self.assertTrue(session.sketch_imprint_external_edges["attached-imprint"]["cap"].wrapped.IsSame(cap_edge.wrapped)) self.assertNotIn("runtime_record", session.sketches["attached-imprint"]) outside = Face.make_rect(10, 10, Plane((0, 0, 2), (1, 0, 0), (0, 0, 1))).edges()[0] bad = ExecutionSession(sketches={"attached-imprint": sketch}, nodes={}) bad_edge_record = TopologyRecord("edge:outside", "edge", "base", "body:base", value=outside) bad.resolve = lambda selector: SelectorResolution( # type: ignore[method-assign] selector=selector, status="resolved", record=support_record if selector.get("tag") == "support" else bad_edge_record, ) with self.assertRaisesRegex(Exception, "not an exact boundary") as rejected: bad.resolve_sketch_attachment("attached-imprint", feature_id="consumer") self.assertEqual(rejected.exception.code, "imprint_external_anchor_not_support_boundary") def test_planar_imprint_external_anchor_requires_an_attached_support(self) -> None: """A profile cannot introduce external topology without an attachment selector.""" from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"][0]["profile"] = { "type": "planar_imprint", "source_entities": [ {"id": "cut", "curve": {"type": "line", "start": [-5, 0], "end": [5, 0]}}, {"id": "other", "curve": {"type": "line", "start": [0, -5], "end": [0, 5]}}, ], "external_anchors": [{"id": "cap", "selector": { "kind": "edge", "stable_id": "never-bind", "source": "runtime_snapshot", "confidence": 1.0, }}], "selections": [{ "source_entity_id": "cut", "face_side": 1, "fragment": {"external_anchor_id": "cap", "side": -1}, }], } with self.assertRaisesRegex(ValueError, "external anchors require a runtime face attachment"): validate_semantic_cdsl(cdsl) def test_analytic_ellipse_preserves_its_workplane_orientation_and_volume(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"][0] = { "id": "ellipse", "workplane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [0, 0, 1]}, "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [{ "type": "ellipse", "center": [0, 0], "major_radius_mm": 5, "minor_radius_mm": 2, "major_axis": [3 / 5, 4 / 5], }], }]}, } cdsl["features"][0]["sketch_id"] = "ellipse" cdsl["features"][0]["params"] = {"distance_mm": 4} sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] edge = sketch["contour_regions_mm"][0]["outer"][0] self.assertEqual(edge["major_axis_mm"], [-0.8, 0.6, 0.0]) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "ellipse.step") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], math.pi * 5 * 2 * 4, places=5) def test_bspline_profile_preserves_endpoint_tangents(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{ "id": "spline", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [ {"type": "line", "start": [0, 0], "end": [4, 0]}, {"type": "bspline", "start": [4, 0], "end": [0, 0], "points": [[4, 0], [4, 3], [0, 0]], "start_tangent": [0, 5], "end_tangent": [-5, 0]}, ], }]}, }]}, "features": [], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] spline = next(edge for edge in sketch["contour_regions_mm"][0]["outer"] if edge["type"] == "bspline") self.assertEqual(spline["start_tangent_mm"], [0.0, 5.0, 0.0]) self.assertEqual(spline["end_tangent_mm"], [-5.0, 0.0, 0.0]) edge = Build123dGeometryAdapter()._wire([spline]).edges()[0] self.assertAlmostEqual(edge.tangent_at(0).Y, 1.0, places=6) self.assertAlmostEqual(edge.tangent_at(1).X, -1.0, places=6) def test_bspline_interpolation_tangent_uses_the_runtime_parameter_domain(self) -> None: from cdsl_engine.build123d_adapter import interpolated_bspline_point_and_tangent points = [(0.0, -23.11, 0.0), (0.0, -5.33, 0.0), (26.7, 9.39, 0.0)] parameters = [0.0, 0.43299474427180723, 1.0] point, tangent = interpolated_bspline_point_and_tangent( points, start_tangent=(0.0, 64.52, 0.0), end_tangent=(141.23, -13.99, 0.0), parameters=parameters, interpolation_index=1, ) for actual, expected in zip(point, points[1]): self.assertAlmostEqual(actual, expected, places=12) self.assertAlmostEqual(tangent[0], 0.008342033594358346, places=10) self.assertAlmostEqual(tangent[1], 36.52292778091852, places=10) def test_two_point_bspline_profile_requires_and_preserves_endpoint_tangents(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{ "id": "two-point-spline", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [ {"type": "line", "start": [0, 0], "end": [4, 0]}, {"type": "bspline", "start": [4, 0], "end": [0, 0], "points": [[4, 0], [0, 0]], "parameters": [0, 1], "start_tangent": [0, 5], "end_tangent": [-5, 0]}, ], }]}, }]}, "features": [], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] spline = next(edge for edge in sketch["contour_regions_mm"][0]["outer"] if edge["type"] == "bspline") edge = Build123dGeometryAdapter()._wire([spline]).edges()[0] self.assertAlmostEqual(edge.tangent_at(0).Y, 1.0, places=6) self.assertAlmostEqual(edge.tangent_at(1).X, -1.0, places=6) with self.assertRaisesRegex(ValueError, "parameters must be finite and strictly increasing"): Build123dGeometryAdapter()._wire([{**spline, "parameters": [0, 0]}]) coincident = deepcopy(cdsl) coincident_spline = coincident["geometry"]["sketches"][0]["profile"]["contours"][0]["segments"][1] coincident_spline["end"] = [4, 0] coincident_spline["points"][-1] = [4, 0] with self.assertRaisesRegex(ValueError, "two-point bspline endpoints must be distinct"): resolve_all_sketches(coincident) incomplete = {**cdsl, "geometry": {"sketches": [{ **cdsl["geometry"]["sketches"][0], "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [ {"type": "line", "start": [0, 0], "end": [4, 0]}, {"type": "bspline", "start": [4, 0], "end": [0, 0], "points": [[4, 0], [0, 0]]}, ], }]}, }]}} with self.assertRaisesRegex(ValueError, "two-point bspline requires both endpoint tangents"): resolve_all_sketches(incomplete) from cdsl_engine.semantic_validation import validate_semantic_cdsl with self.assertRaisesRegex(ValueError, "CDSL schema violation"): validate_semantic_cdsl(incomplete) def test_drafted_ellipse_exports_as_a_solid(self) -> None: from build123d import import_step from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "ellipse", "workplane": {"origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "normal": [0, 0, 1]}, "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [{ "type": "ellipse", "center": [0, 0], "major_radius_mm": 3, "minor_radius_mm": 2, "major_axis": [1, 0], }], }]}, }) cdsl["features"].append({ "id": "drafted_ellipse", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "params": {"distance_mm": 4, "draft": {"angle_deg": 1, "pull_direction": False}}, "sketch_id": "ellipse", }) with tempfile.TemporaryDirectory() as directory: output = Path(directory) / "drafted-ellipse.step" result = rebuild_cdsl(cdsl, output) exported = import_step(str(output)) self.assertEqual(result["solid_count"], 1) self.assertEqual(len(exported.solids()), 1) self.assertGreater(float(exported.volume), 1000.0) def test_boolean_bodies_subtracts_explicit_new_body_sources(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "boolean-bodies", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "outer", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 10}}, {"id": "inner", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 4}}, ]}, "features": [ {"id": "outer_body", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "outer", "params": {"distance_mm": 10, "result_mode": "new_body"}}, {"id": "inner_body", "atomic_id": "extrude_add_blind", "depends_on": ["outer_body"], "sketch_id": "inner", "params": {"distance_mm": 10, "result_mode": "new_body"}}, {"id": "cut", "atomic_id": "boolean_bodies", "depends_on": ["outer_body", "inner_body"], "params": {"operation": "subtract", "target_feature_ids": ["outer_body"], "tool_feature_ids": ["inner_body"], "keep_tools": False}}, ], } with tempfile.TemporaryDirectory() as tmp: rebuilt = rebuild_cdsl(cdsl, Path(tmp) / "boolean.step") self.assertEqual(rebuilt["solid_count"], 1) self.assertAlmostEqual(rebuilt["volume_mm3"], math.pi * (10 ** 2 - 4 ** 2) * 10) self.assertEqual([item["feature_id"] for item in rebuilt["feature_results"]], ["outer_body", "inner_body", "cut"]) modified_cap = next( item for item in rebuilt["topology_records"] if item["feature_id"] == "cut" and item["kind"] == "face" and item["geometry"].get("surface_type") == "plane" and abs(item["geometry"].get("area_mm2", 0) - math.pi * (10 ** 2 - 4 ** 2)) < 1e-5 ) self.assertEqual(modified_cap["owner_feature_ids"], ["outer_body"]) delta = next(item for item in rebuilt["topology_deltas"] if item["operation"] == "subtract") self.assertTrue(any( item["event"] == "modified" and item["status"] == "unique_exact_continuation" for item in delta["relations"] )) def test_boolean_union_and_intersect_capture_exact_kernel_history(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cases = ( ( "union", _rectangle([-4, -2], [0, 2]), _rectangle([4, -2], [8, 2]), 128.0, 2, ), ( "intersect", _rectangle([-4, -2], [2, 2]), _rectangle([-1, -2], [5, 2]), 48.0, 1, ), ) for operation, left, right, volume, solid_count in cases: with self.subTest(operation=operation): with tempfile.TemporaryDirectory() as directory: rebuilt = rebuild_cdsl( _two_body_boolean_cdsl(operation, left, right), Path(directory) / f"{operation}.step", ) self.assertAlmostEqual(rebuilt["volume_mm3"], volume) self.assertEqual(rebuilt["solid_count"], solid_count) delta = next(item for item in rebuilt["topology_deltas"] if item["operation"] == operation) self.assertTrue(any( item["status"] == "unique_exact_continuation" for item in delta["relations"] )) self.assertTrue(any( item["owner_feature_ids"] == ["left_body"] for item in rebuilt["topology_records"] if item["feature_id"] == "boolean" and item["kind"] in {"face", "edge", "vertex"} )) def test_targetless_body_set_keep_tools_retains_the_complete_input_set(self) -> None: """The lowered left operand is still an original tool for keepTools.""" from cdsl_engine.runtime import prepare_cdsl_execution cdsl = _two_body_boolean_cdsl( "intersect", _rectangle([-4, -2], [2, 2]), _rectangle([-1, -2], [5, 2]), ) boolean = cdsl["features"][-1] boolean["params"]["keep_tools"] = True boolean["params"]["targetless_body_set"] = True execution = prepare_cdsl_execution(cdsl) self.assertTrue(all(item.executable for item in execution.analysis.feature_results)) execution.execute_all() self.assertEqual(set(execution.session.body_members), {"left_body", "right_body", "boolean"}) self.assertAlmostEqual(float(execution.session.body_members["left_body"].volume), 96.0) self.assertAlmostEqual(float(execution.session.body_members["right_body"].volume), 96.0) self.assertAlmostEqual(float(execution.session.body_members["boolean"].volume), 48.0) def test_boolean_intersection_owner_selector_executes_downstream_fillet(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = _two_body_boolean_cdsl( "intersect", _rectangle([-4, -2], [2, 2]), _rectangle([-1, -2], [5, 2]), ) with tempfile.TemporaryDirectory() as directory: root = Path(directory) intersected = rebuild_cdsl(cdsl, root / "intersected.step") edge = next( item for item in intersected["topology_records"] if item["feature_id"] == "boolean" and item["kind"] == "edge" and item["owner_feature_ids"] == ["left_body"] ) filleted = deepcopy(cdsl) filleted["features"].append({ "id": "fillet", "atomic_id": "fillet", "depends_on": ["boolean"], "params": {"radius_mm": 0.25}, "selectors": [{ "kind": "edge", "stable_id": "intersection-left-edge", "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "left_body", "geometry": edge["geometry"], }], }) rebuilt = rebuild_cdsl(filleted, root / "filleted.step") self.assertEqual([item["feature_id"] for item in rebuilt["feature_results"]], [ "left_body", "right_body", "boolean", "fillet", ]) self.assertLess(rebuilt["volume_mm3"], intersected["volume_mm3"]) def test_single_body_dressups_capture_kernel_history_only_for_direct_builder_paths(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "base.step") edge = next(item for item in baseline["topology_records"] if item["kind"] == "edge") for atomic_id, params in (("fillet", {"radius_mm": 1}), ("chamfer", {"distance_mm": 1})): with self.subTest(atomic_id=atomic_id): dressed = deepcopy(base) dressed["features"].append({ "id": atomic_id, "atomic_id": atomic_id, "depends_on": ["base_add"], "params": params, "selectors": [{ "kind": "edge", "stable_id": "base-edge", "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": edge["geometry"], }], }) result = rebuild_cdsl(dressed, root / f"{atomic_id}.step") delta = next(item for item in result["topology_deltas"] if item["operation"] == atomic_id) self.assertTrue(any( item["status"] == "unique_exact_continuation" for item in delta["relations"] )) self.assertTrue(any( item["event"] == "generated" and item["status"] == "recorded_without_owner_transfer" for item in delta["relations"] )) # Dress-up builders create the patch as a FACE from the # selected EDGE. Keep this cross-kind OCC fact explicit; # it is diagnostic lineage only, not a BLEND_EDGE selector. self.assertTrue(any( item["event"] == "generated" and item["source_kind"] == "edge" and item["result_kind"] == "face" and item["coverage"] == "complete" and item["lineage_status"] == "proven" for item in delta["relations"] )) self.assertTrue(any( item.get("blend_transition") is True and item["status"] == "exact_blend_boundary" and item["source_kind"] == "edge" and item["result_kind"] == "edge" and len(item["source_record_ids"]) == 1 and len(item["blend_into_source_record_ids"]) == 1 and len(item["blend_into_result_record_ids"]) == 1 and len(item["patch_face_record_ids"]) == 1 and len(item["result_record_ids"]) == 1 for item in delta["relations"] )) self.assertTrue(any( item["owner_feature_ids"] == ["base_add"] for item in result["topology_records"] if item["feature_id"] == atomic_id and item["kind"] in {"face", "edge"} )) angled = deepcopy(base) angled["features"].append({ "id": "angled", "atomic_id": "chamfer", "depends_on": ["base_add"], "params": {"distance_mm": 1, "distance_2_mm": 0.5}, "selectors": [{ "kind": "edge", "stable_id": "base-edge", "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": edge["geometry"], }], }) angled_result = rebuild_cdsl(angled, root / "angled.step") self.assertFalse(any(item["operation"] == "chamfer" for item in angled_result["topology_deltas"])) def test_single_member_multibody_dressup_preserves_other_members_and_history(self) -> None: """A dress-up on one Compound member must not discard its OCC delta.""" from cdsl_engine.runtime import prepare_cdsl_execution base = _two_body_boolean_cdsl( "union", _rectangle([-12, -4], [-4, 4]), _rectangle([4, -4], [12, 4]), ) base["features"] = base["features"][:2] execution = prepare_cdsl_execution(base) execution.execute_all() edge = next( record for record in execution.session.topology.records() if record.feature_id == "right_body" and record.kind == "edge" and record.owners == ("right_body",) ) for atomic_id, params in (("fillet", {"radius_mm": 0.5}), ("chamfer", {"distance_mm": 0.5})): with self.subTest(atomic_id=atomic_id): dressed = deepcopy(base) dressed["features"].append({ "id": atomic_id, "atomic_id": atomic_id, "depends_on": ["left_body", "right_body"], "params": params, "selectors": [{ "kind": "edge", "stable_id": edge.record_id, "snapshot_id": edge.record_id, "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "right_body", "geometry": edge.geometry, }], }) execution = prepare_cdsl_execution(dressed) execution.execute_all() self.assertEqual(set(execution.session.body_members), {"left_body", atomic_id}) delta = next( item for item in execution.session.topology.topology_deltas() if item["feature_id"] == atomic_id ) self.assertTrue(delta["relations"]) self.assertTrue(any( item["event"] == "generated" and item["source_kind"] == "edge" and item["result_kind"] == "face" and item["coverage"] == "complete" for item in delta["relations"] )) self.assertTrue(any( lineage.operation == "body_member_preserve" and lineage.feature_id == atomic_id and lineage.source_kind == "edge" for lineage in execution.session.topology.lineage() )) def test_shell_captures_exact_kernel_history_for_downstream_selector(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "base.step") removed_face = next( item for item in baseline["topology_records"] if item["kind"] == "face" and item["feature_id"] == "base_add" and item["geometry"].get("surface_type") == "plane" and item["geometry"].get("normal", [0, 0, 0])[2] > 0.9 ) shelled = deepcopy(base) shelled["features"].append({ "id": "shell", "atomic_id": "shell", "depends_on": ["base_add"], "params": {"thickness_mm": 1, "inward": True}, "selectors": [{ "kind": "face", "stable_id": removed_face["record_id"], "snapshot_id": removed_face["record_id"], "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": removed_face["geometry"], }], }) shell_result = rebuild_cdsl(shelled, root / "shell.step") delta = next(item for item in shell_result["topology_deltas"] if item["operation"] == "shell") continuation = next( item for item in delta["relations"] if item["kind"] == "edge" and item["status"] == "unique_exact_continuation" ) source_id = continuation["source_record_ids"][0] result_id = continuation["result_record_ids"][0] successor = next(item for item in shell_result["topology_records"] if item["record_id"] == result_id) downstream = deepcopy(shelled) downstream["features"].append({ "id": "fillet", "atomic_id": "fillet", "depends_on": ["shell"], "params": {"radius_mm": 0.25}, "selectors": [{ "kind": "edge", "stable_id": source_id, "snapshot_id": result_id, "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": successor["geometry"], }], }) downstream_result = rebuild_cdsl(downstream, root / "shell-fillet.step") self.assertTrue(any( item["event"] == "generated" and item["status"] == "recorded_without_owner_transfer" for item in delta["relations"] )) self.assertTrue(any( item["event"] == "generated" and item.get("output_role") == "shell.offset_face" for item in delta["relations"] )) self.assertTrue(any( item.get("output_role") == "shell.closing_descendant" for item in delta["relations"] )) self.assertTrue(any( item.get("output_role") == "shell.wall" for item in delta["relations"] )) self.assertTrue(any( item["status"] == "unique_exact_continuation" for item in delta["relations"] )) self.assertEqual(successor["owner_feature_ids"], ["base_add"]) self.assertEqual([item["feature_id"] for item in downstream_result["feature_results"]], [ "base_add", "shell", "fillet", ]) self.assertEqual(downstream_result["runtime_diagnostics"], []) def test_body_transform_copy_and_explicit_delete_preserve_unselected_members(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "body-transform-delete", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "source", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 2}, }]}, "features": [ {"id": "source_body", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "source", "params": {"distance_mm": 5, "result_mode": "new_body"}}, {"id": "copied_body", "atomic_id": "transform_bodies", "depends_on": ["source_body"], "params": { "source_feature_ids": ["source_body"], "transform": {"type": "translation", "translation_mm": [10, 0, 0]}, "make_copy": True, }}, {"id": "remove_copy", "atomic_id": "delete_bodies", "depends_on": ["copied_body"], "params": {"target_feature_ids": ["copied_body"]}}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "body-transform-delete.step") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], math.pi * 2 ** 2 * 5) self.assertEqual(result["bbox_mm"], {"min": [-2.0, -2.0, 0.0], "max": [2.0, 2.0, 5.0]}) self.assertEqual([item["feature_id"] for item in result["feature_results"]], ["source_body", "copied_body", "remove_copy"]) def test_multi_source_transform_copy_preserves_source_qualified_members(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "multi-source-copy", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "left", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 1}}, {"id": "right", "workplane": _workplane(), "profile": {"type": "circle", "center": [10, 0], "radius_mm": 1}}, ]}, "features": [ {"id": "left_body", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "left", "params": {"distance_mm": 2, "result_mode": "new_body"}}, {"id": "right_body", "atomic_id": "extrude_add_blind", "depends_on": ["left_body"], "sketch_id": "right", "params": {"distance_mm": 2, "result_mode": "new_body"}}, {"id": "copy_pair", "atomic_id": "transform_bodies", "depends_on": ["left_body", "right_body"], "params": { "source_feature_ids": ["left_body", "right_body"], "transform": {"type": "translation", "translation_mm": [0, 10, 0]}, "make_copy": True, }}, {"id": "move_left_copy", "atomic_id": "transform_bodies", "depends_on": ["copy_pair"], "params": { "transform_copy_refs": [{"transform_feature_id": "copy_pair", "source_feature_id": "left_body"}], "transform": {"type": "translation", "translation_mm": [0, 0, 10]}, "make_copy": False, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "multi-source-copy.step") self.assertEqual(result["solid_count"], 4) self.assertAlmostEqual(result["volume_mm3"], 4 * math.pi * 2, places=5) self.assertEqual(result["bbox_mm"], {"min": [-1.0, -1.0, 0.0], "max": [11.0, 11.0, 12.0]}) self.assertEqual([item["feature_id"] for item in result["feature_results"]], [ "left_body", "right_body", "copy_pair", "move_left_copy", ]) def test_boolean_consumes_only_source_qualified_multi_source_copy_members(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "multi-source-copy-boolean", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "left", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 1}}, {"id": "right", "workplane": _workplane(), "profile": {"type": "circle", "center": [10, 0], "radius_mm": 1}}, ]}, "features": [ {"id": "left_body", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "left", "params": {"distance_mm": 2, "result_mode": "new_body"}}, {"id": "right_body", "atomic_id": "extrude_add_blind", "depends_on": ["left_body"], "sketch_id": "right", "params": {"distance_mm": 2, "result_mode": "new_body"}}, {"id": "copy_pair", "atomic_id": "transform_bodies", "depends_on": ["left_body", "right_body"], "params": { "source_feature_ids": ["left_body", "right_body"], "transform": {"type": "translation", "translation_mm": [0, 10, 0]}, "make_copy": True, }}, {"id": "join_copies", "atomic_id": "boolean_bodies", "depends_on": ["copy_pair"], "params": { "operation": "union", "target_transform_copy_refs": [{"transform_feature_id": "copy_pair", "source_feature_id": "left_body"}], "tool_transform_copy_refs": [{"transform_feature_id": "copy_pair", "source_feature_id": "right_body"}], "keep_tools": False, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "multi-source-copy-boolean.step") self.assertEqual(result["solid_count"], 4) self.assertAlmostEqual(result["volume_mm3"], 4 * math.pi * 2, places=5) self.assertEqual(result["bbox_mm"], {"min": [-1.0, -1.0, 0.0], "max": [11.0, 11.0, 2.0]}) self.assertEqual([item["feature_id"] for item in result["feature_results"]], [ "left_body", "right_body", "copy_pair", "join_copies", ]) def test_boolean_transform_copy_reference_rejects_unselected_source(self) -> None: from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() cdsl["features"][0]["params"]["result_mode"] = "new_body" cdsl["features"].extend([ {"id": "second_body", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "sketch_id": "base", "params": {"distance_mm": 5, "result_mode": "new_body"}}, {"id": "copy_pair", "atomic_id": "transform_bodies", "depends_on": ["base_add", "second_body"], "params": { "source_feature_ids": ["base_add", "second_body"], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": True, }}, {"id": "join", "atomic_id": "boolean_bodies", "depends_on": ["copy_pair"], "params": { "operation": "union", "target_transform_copy_refs": [{"transform_feature_id": "copy_pair", "source_feature_id": "missing_body"}], "tool_feature_ids": ["base_add"], "keep_tools": False, }}, ]) for feature in cdsl["features"]: feature["execution_status"] = "supported" with self.assertRaisesRegex(ValueError, "names a source outside its transform"): validate_semantic_cdsl(cdsl) def test_transform_copy_reference_rejects_unselected_source(self) -> None: from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() cdsl["features"][0]["params"]["result_mode"] = "new_body" cdsl["features"].extend([ {"id": "second_body", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "sketch_id": "base", "params": {"distance_mm": 5, "result_mode": "new_body"}}, {"id": "copy_pair", "atomic_id": "transform_bodies", "depends_on": ["base_add", "second_body"], "params": { "source_feature_ids": ["base_add", "second_body"], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": True, }}, {"id": "move", "atomic_id": "transform_bodies", "depends_on": ["copy_pair"], "params": { "transform_copy_refs": [{"transform_feature_id": "copy_pair", "source_feature_id": "missing_body"}], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": False, }}, ]) for feature in cdsl["features"]: feature["execution_status"] = "supported" with self.assertRaisesRegex(ValueError, "names a source outside its transform"): validate_semantic_cdsl(cdsl) def test_body_uniform_scale_uses_its_explicit_center_and_preserves_topology_provenance(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "body-uniform-scale", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "source", "workplane": _workplane(), "profile": {"type": "circle", "center": [10, 0], "radius_mm": 2}, }]}, "features": [ {"id": "source_body", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "source", "params": {"distance_mm": 5, "result_mode": "new_body"}}, {"id": "scaled_body", "atomic_id": "transform_bodies", "depends_on": ["source_body"], "params": { "source_feature_ids": ["source_body"], "transform": {"type": "uniform_scale", "center_mm": [10, 0, 0], "scale_factor": 0.5}, "make_copy": False, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "body-uniform-scale.step") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], math.pi * 2 ** 2 * 5 / 8) self.assertEqual(result["bbox_mm"], {"min": [9.0, -1.0, 0.0], "max": [11.0, 1.0, 2.5]}) self.assertTrue(any(item["operation"] == "uniform_scale" for item in result["topology_deltas"])) def test_kernel_transform_delta_preserves_owner_and_rejects_stale_geometry(self) -> None: from build123d import Solid from cdsl_engine.build123d_adapter import Build123dGeometryAdapter adapter = Build123dGeometryAdapter() source = Solid.make_box(2, 3, 4) cases = ( ("translation", {"type": "translation", "translation_mm": [7, -3, 2]}), ("rotation", { "type": "rotation", "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "angle_deg": 90, }), ("uniform_scale", {"type": "uniform_scale", "center_mm": [1, 1.5, 2], "scale_factor": 0.5}), ) for name, transform in cases: with self.subTest(transform=name): moved, delta = adapter.transform_with_topology_delta(source, transform) registry = TopologyRegistry() source_records = adapter.topology_records(source, "base", "body:base") registry.replace_body_topology("base", "body:base", source_records) registry.replace_body_topology( "move", "body:move", adapter.topology_records(moved, "move", "body:move"), topology_delta=delta, ) moved_face = next(record for record in registry.records_for_feature("move") if record.kind == "face") resolved = registry.resolve({ "kind": "face", "owner_feature_id": "base", "geometry": moved_face.geometry, }, active_body_id="body:move") stale = registry.resolve({ "kind": "face", "owner_feature_id": "base", "geometry": source_records[0].geometry, }, active_body_id="body:move") self.assertEqual(moved_face.owner_feature_ids, ("base",)) self.assertEqual(resolved.status, "resolved") self.assertEqual(stale.status, "not_found") evidence = registry.topology_deltas()[0] self.assertEqual(evidence["operation"], name) self.assertTrue(any( item["status"] == "unique_exact_continuation" for item in evidence["relations"] )) def test_non_unique_or_incomplete_kernel_history_does_not_transfer_owner(self) -> None: first_source = object() second_source = object() result = object() registry = TopologyRegistry() registry.replace_body_topology("base", "body:base", [ TopologyRecord("base:first", "face", "base", "body:base", {"center_mm": [0, 0, 0]}, first_source), TopologyRecord("base:second", "face", "other", "body:base", {"center_mm": [0, 0, 0]}, second_source), ]) registry.replace_body_topology("move", "body:move", [ TopologyRecord("move:face", "face", "move", "body:move", {"center_mm": [7, 0, 0]}, result), ], topology_delta=TopologyDelta("translation", ( TopologyDeltaRelation("modified", "face", first_source, (result,)), TopologyDeltaRelation("modified", "face", second_source, (result,)), ))) moved = registry.records_for_feature("move")[0] statuses = [item["status"] for item in registry.topology_deltas()[0]["relations"]] self.assertEqual(moved.owner_feature_ids, ("move",)) self.assertEqual(statuses, ["ambiguous_exact_continuation", "ambiguous_exact_continuation"]) self.assertEqual(registry.resolve({ "kind": "face", "stable_id": "base:first", "owner_feature_id": "base", }, active_body_id="body:move").status, "not_found") def test_kernel_deleted_history_blocks_geometry_drift_successor_guessing(self) -> None: registry = TopologyRegistry() source = object() registry.replace_body_topology("base", "body:base", [ TopologyRecord("base:edge", "edge", "base", "body:base", { "curve_type": "line", "start_mm": [0, 0, 0], "end_mm": [0, 0, 10], }, source), ]) registry.replace_body_topology("dress_up", "body:dress_up", [ TopologyRecord("dress_up:edge", "edge", "dress_up", "body:dress_up", { "curve_type": "line", "start_mm": [0, 0, 1], "end_mm": [0, 0, 9], }, object()), ], topology_delta=TopologyDelta("fillet", ( TopologyDeltaRelation("deleted", "edge", source), ))) self.assertNotIn("base:edge", registry._successors) self.assertEqual(registry.topology_deltas()[0]["relations"][0]["status"], "recorded_without_owner_transfer") def test_inactive_stable_id_without_geometry_does_not_bind_a_unique_active_candidate(self) -> None: registry = TopologyRegistry() registry.replace_body_topology("base", "body:base", [ TopologyRecord("base:edge", "edge", "base", "body:base", {"center_mm": [0, 0, 0]}), ]) registry.replace_body_topology("later", "body:later", [ TopologyRecord("later:edge", "edge", "later", "body:later", {"center_mm": [5, 0, 0]}), ]) resolution = registry.resolve({"kind": "edge", "stable_id": "base:edge"}, active_body_id="body:later") self.assertEqual(resolution.status, "not_found") self.assertEqual(resolution.diagnostic.code, "selector_stable_id_inactive") def test_output_role_selector_binds_only_unique_active_kernel_evidence(self) -> None: registry = TopologyRegistry() source_face = object() sweep_end = object() registry.replace_body_topology("base", "body:base", [ TopologyRecord("base:face", "face", "base", "body:base", {"center_mm": [0, 0, 0]}, source_face), ]) registry.replace_body_topology("sweep", "body:sweep", [ TopologyRecord("sweep:end", "face", "sweep", "body:sweep", {"center_mm": [0, 0, 10]}, sweep_end), ], topology_delta=TopologyDelta("sweep", ( TopologyDeltaRelation("generated", "face", object(), (sweep_end,), output_role="sweep.end"), ))) resolved = registry.resolve({ "kind": "face", "owner_feature_id": "sweep", "output_role": "sweep.end", }, active_body_id="body:sweep") evidence = registry.topology_deltas()[0]["relations"][0] self.assertEqual(resolved.status, "resolved") self.assertEqual(resolved.record.record_id, "sweep:end") self.assertEqual(resolved.record.output_roles, ("sweep.end",)) self.assertEqual(evidence["output_role_status"], "unique_result_snapshot") registry.replace_body_topology("later", "body:later", [ TopologyRecord("later:end", "face", "later", "body:later", {"center_mm": [0, 0, 10]}, object()), ]) stale = registry.resolve({ "kind": "face", "owner_feature_id": "sweep", "output_role": "sweep.end", }, active_body_id="body:later") self.assertEqual(stale.status, "not_found") self.assertEqual(stale.diagnostic.code, "selector_output_role_not_found") def test_provenance_selector_uses_exact_lineage_not_geometry_successors(self) -> None: registry = TopologyRegistry() source = object() exact_result = object() geometrically_similar = object() source_anchor = TopologyRecord( "anchor:base:circle", "edge", "base", geometry={}, value=source, source_entity=("sketch_base", "circle"), ) registry.register(source_anchor) registry.replace_body_topology("later", "body:later", [ TopologyRecord("later:exact", "face", "later", "body:later", {"center_mm": [10, 0, 0]}, exact_result), TopologyRecord("later:similar", "face", "later", "body:later", {"center_mm": [0, 0, 0]}, geometrically_similar), ], topology_delta=TopologyDelta("extrude", ( TopologyDeltaRelation( "generated", "edge", source, (exact_result,), source_kind="edge", result_kind="face", derivation="boundary", ), )), additional_predecessors=[source_anchor]) selector = { "kind": "face", "owner_feature_id": "base", "source": "runtime_snapshot", "confidence": 1.0, "geometry": {"center_mm": [0, 0, 0]}, "selector_intent": { "version": "1.0", "kind": "face", "query_family": "SWEPT_FACE", "source_query": { "ast": {}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "source_entity": {"sketch_id": "sketch_base", "entity_id": "circle"}, "derivation_policy": {"allowed": ["boundary"], "multiplicity": "one"}, "evidence": "kernel_history", }, } resolution = registry.resolve(selector, active_body_id="body:later") self.assertEqual(resolution.status, "resolved") self.assertEqual(resolution.record.record_id, "later:exact") self.assertEqual(registry.lineage()[0].derivation, "boundary") def test_complete_continuation_ignores_nonfinal_builder_handles(self) -> None: """A boolean's intermediate Generated handles are not face fragments. OCC can return both one final ``Modified(face)`` and Generated faces which are absent from the result snapshot for the same source face. The latter are useful diagnostics but cannot invalidate the exact one-to-one target continuation. """ registry = TopologyRegistry() source_edge = object() initial_face = object() final_face = object() intermediate_face = object() anchor = TopologyRecord( "anchor:base:edge", "edge", "base", geometry={}, value=source_edge, source_entity=("sketch_base", "edge"), ) registry.register(anchor) registry.replace_body_topology("base", "body:base", [ TopologyRecord("base:wall", "face", "base", "body:base", {}, initial_face), ], topology_delta=TopologyDelta("extrude", ( TopologyDeltaRelation( "generated", "edge", source_edge, (initial_face,), source_kind="edge", result_kind="face", derivation="boundary", ), )), additional_predecessors=[anchor]) registry.replace_body_topology("cut", "body:cut", [ TopologyRecord("cut:wall", "face", "cut", "body:cut", {}, final_face), ], topology_delta=TopologyDelta("subtract", ( TopologyDeltaRelation("modified", "face", initial_face, (final_face,)), TopologyDeltaRelation( "generated", "face", initial_face, (intermediate_face,), derivation="boundary", ), ))) resolution = registry.resolve({ "kind": "face", "owner_feature_id": "base", "source": "runtime_snapshot", "confidence": 1.0, "selector_intent": { "version": "1.0", "kind": "face", "query_family": "SWEPT_FACE", "source_query": { "ast": {}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "source_entity": {"sketch_id": "sketch_base", "entity_id": "edge"}, "derivation_policy": {"allowed": ["boundary", "continuation"], "multiplicity": "one"}, "evidence": "kernel_history", }, }, active_body_id="body:cut") self.assertEqual(resolution.status, "resolved") self.assertEqual(resolution.record.record_id, "cut:wall") cut_relations = registry.topology_deltas()[-1]["relations"] self.assertTrue(any(item["coverage"] == "partial" for item in cut_relations)) def test_provenance_selector_rejects_non_unique_fragment(self) -> None: registry = TopologyRegistry() source = object() first = object() second = object() source_anchor = TopologyRecord( "anchor:base:vertex", "vertex", "base", geometry={}, value=source, source_entities=(("sketch_base", "left"), ("sketch_base", "right")), ) registry.register(source_anchor) registry.replace_body_topology("fillet", "body:fillet", [ TopologyRecord("fillet:first", "edge", "fillet", "body:fillet", {"center_mm": [0, 0, 0]}, first), TopologyRecord("fillet:second", "edge", "fillet", "body:fillet", {"center_mm": [1, 0, 0]}, second), ], topology_delta=TopologyDelta("fillet", ( TopologyDeltaRelation( "modified", "vertex", source, (first, second), source_kind="vertex", result_kind="edge", derivation="fragment", ), )), additional_predecessors=[source_anchor]) resolution = registry.resolve({ "kind": "edge", "owner_feature_id": "base", "source": "runtime_snapshot", "confidence": 1.0, "selector_intent": { "version": "1.0", "kind": "edge", "query_family": "SWEPT_EDGE", "source_query": { "ast": {}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "source_entities": [ {"sketch_id": "sketch_base", "entity_id": "left"}, {"sketch_id": "sketch_base", "entity_id": "right"}, ], "derivation_policy": {"allowed": ["fragment"], "multiplicity": "one"}, "evidence": "kernel_history", }, }, active_body_id="body:fillet") self.assertEqual(resolution.status, "ambiguous") self.assertEqual(resolution.diagnostic.code, "selector_relation_non_unique") def test_provenance_selector_returns_all_proven_fragments(self) -> None: registry = TopologyRegistry() source = object() first = object() second = object() source_anchor = TopologyRecord( "anchor:base:vertex", "vertex", "base", geometry={}, value=source, source_entities=(("sketch_base", "left"), ("sketch_base", "right")), ) registry.register(source_anchor) registry.replace_body_topology("fillet", "body:fillet", [ TopologyRecord("fillet:first", "edge", "fillet", "body:fillet", {}, first), TopologyRecord("fillet:second", "edge", "fillet", "body:fillet", {}, second), ], topology_delta=TopologyDelta("fillet", ( TopologyDeltaRelation( "modified", "vertex", source, (first, second), source_kind="vertex", result_kind="edge", derivation="fragment", ), )), additional_predecessors=[source_anchor]) resolution = registry.resolve({ "kind": "edge", "owner_feature_id": "base", "source": "runtime_snapshot", "confidence": 1.0, "selector_intent": { "version": "1.0", "kind": "edge", "query_family": "SWEPT_EDGE", "source_query": { "ast": {}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "source_entities": [ {"sketch_id": "sketch_base", "entity_id": "left"}, {"sketch_id": "sketch_base", "entity_id": "right"}, ], "derivation_policy": {"allowed": ["fragment"], "multiplicity": "all_fragments"}, "evidence": "kernel_history", }, }, active_body_id="body:fillet") self.assertEqual(resolution.status, "resolved") self.assertIsNone(resolution.record) self.assertEqual([record.record_id for record in resolution.records], ["fillet:first", "fillet:second"]) def test_fillet_consumes_all_proven_fragment_records(self) -> None: """A dress-up must consume every record allowed by all_fragments.""" from build123d import Box from cdsl_engine.build123d_adapter import Build123dGeometryAdapter from cdsl_engine.runtime import ExecutionSession, FeaturePlanNode, execute_node class RecordingAdapter(Build123dGeometryAdapter): def __init__(self) -> None: self.selected_edges: list[object] = [] def fillet_with_topology_delta(self, body, radius_mm, edges): self.selected_edges = list(edges) # Selection delivery is the behavior under test. Returning the # same valid B-rep keeps this focused on the executor contract. return body, None adapter = RecordingAdapter() body = Box(10, 10, 10) first, second = body.edges()[:2] source = object() session = ExecutionSession(sketches={}, nodes={}, adapter=adapter) session.body = body session.body_id = "body:fragments" session.body_members = {"fragments": body} source_anchor = TopologyRecord( "anchor:source:vertex", "vertex", "source", geometry={}, value=source, source_entities=(("sketch_source", "left"), ("sketch_source", "right")), ) session.topology.register(source_anchor) session.topology.replace_body_topology("fragments", "body:fragments", [ TopologyRecord("fragments:first", "edge", "fragments", "body:fragments", value=first), TopologyRecord("fragments:second", "edge", "fragments", "body:fragments", value=second), ], topology_delta=TopologyDelta("split", ( TopologyDeltaRelation( "modified", "vertex", source, (first, second), source_kind="vertex", result_kind="edge", derivation="fragment", ), )), additional_predecessors=[source_anchor]) node = FeaturePlanNode( "fillet", "fillet", None, ("fragments",), {"radius_mm": 0.5}, ({ "kind": "edge", "owner_feature_id": "source", "source": "runtime_snapshot", "confidence": 1.0, "selector_intent": { "version": "1.0", "kind": "edge", "query_family": "SWEPT_EDGE", "source_query": { "ast": {}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "source_entities": [ {"sketch_id": "sketch_source", "entity_id": "left"}, {"sketch_id": "sketch_source", "entity_id": "right"}, ], "derivation_policy": {"allowed": ["fragment"], "multiplicity": "all_fragments"}, }, },), None, "supported", {"id": "fillet"}, ) result = execute_node(node, session) self.assertEqual(result.status, "executed") self.assertEqual(len(adapter.selected_edges), 2) self.assertTrue(adapter.selected_edges[0].is_same(first)) self.assertTrue(adapter.selected_edges[1].is_same(second)) self.assertEqual( [record["record_id"] for record in session.selector_resolutions[-1]["records"]], ["fragments:first", "fragments:second"], ) def test_boolean_section_edges_are_recorded_as_intersection_lineage(self) -> None: registry = TopologyRegistry() section_edge = object() registry.replace_body_topology("boolean", "body:boolean", [ TopologyRecord("boolean:section", "edge", "boolean", "body:boolean", {}, section_edge), ], topology_delta=TopologyDelta("intersect", section_values=(section_edge,))) delta = registry.topology_deltas()[0] lineage = delta["lineage"][0] self.assertEqual(lineage["derivation"], "intersection") self.assertEqual(lineage["result_record_ids"], ["boolean:section"]) self.assertTrue(delta["relations"][0]["section_edge"]) def test_boolean_builder_qualifies_section_edges_with_exact_input_faces(self) -> None: from build123d import Location, Solid from cdsl_engine.build123d_adapter import Build123dGeometryAdapter adapter = Build123dGeometryAdapter() target = Solid.make_box(10, 10, 10) tool = Solid.make_box(10, 10, 10).moved(Location((5, 5, 5))) result, delta = adapter.cut_with_topology_delta(target, tool) self.assertTrue(result.is_valid) self.assertIsNotNone(delta) self.assertTrue(delta.section_relations) final_edges = [edge.wrapped for edge in result.edges()] target_faces = [face.wrapped for face in target.faces()] tool_faces = [face.wrapped for face in tool.faces()] for relation in delta.section_relations: self.assertTrue(any(relation.result_value.IsSame(edge) for edge in final_edges)) self.assertTrue(any(relation.source_values[0].IsSame(face) for face in target_faces)) self.assertTrue(any(relation.source_values[1].IsSame(face) for face in tool_faces)) # Qualified results must not also be exposed through the unqualified # SectionEdges-only diagnostic channel. self.assertFalse(delta.section_values) def test_boolean_section_selector_executes_through_source_qualified_lineage(self) -> None: from cdsl_engine.runtime import rebuild_cdsl def source_rectangle(points: list[list[float]]) -> list[dict]: return [ {"type": "line", "start": start, "end": end, "source_entity_id": f"E{index}"} for index, (start, end) in enumerate(zip(points, [*points[1:], points[0]])) ] workplane = _workplane() cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "section-selector", "meta": {"unit": "mm"}, "geometry": {"sketches": [ { "id": "left_sketch", "source_sketch_id": "L", "workplane": workplane, "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": source_rectangle([[0, 0], [10, 0], [10, 10], [0, 10]]), }]}, }, { "id": "right_sketch", "source_sketch_id": "R", "workplane": workplane, "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": source_rectangle([[5, -5], [15, -5], [15, 5], [5, 5]]), }]}, }, ]}, "features": [ { "id": "left", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "left_sketch", "params": {"distance_mm": 4, "result_mode": "new_body"}, }, { "id": "right", "atomic_id": "extrude_add_blind", "depends_on": ["left"], "sketch_id": "right_sketch", "params": {"distance_mm": 4, "result_mode": "new_body"}, }, { "id": "boolean", "atomic_id": "boolean_bodies", "depends_on": ["left", "right"], "params": { "operation": "subtract", "target_feature_ids": ["left"], "tool_feature_ids": ["right"], "keep_tools": False, }, }, { "id": "fillet", "atomic_id": "fillet", "depends_on": ["boolean"], "params": {"radius_mm": 0.1}, "selectors": [{ "kind": "edge", "owner_feature_id": "boolean", "source": "runtime_snapshot", "confidence": 1.0, "selector_intent": { "version": "1.0", "kind": "edge", "query_family": "INTERSECT", "source_query": { "ast": {"call": "makeQuery"}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "derivation_policy": {"allowed": ["intersection"], "multiplicity": "one"}, "evidence": "kernel_history", "intersection_sources": [ { "query_family": "SWEPT_FACE", "owner_feature_id": "left", "source_entity": {"sketch_id": "L", "entity_id": "E0"}, }, { "query_family": "SWEPT_FACE", "owner_feature_id": "right", "source_entity": {"sketch_id": "R", "entity_id": "E3"}, }, ], }, }], }, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "section-selector.step") self.assertEqual(result["feature_results"][-1]["feature_id"], "fillet") section_relations = [ relation for delta in result["topology_deltas"] if delta["feature_id"] == "boolean" for relation in delta["relations"] if relation.get("source_qualified") ] self.assertTrue(section_relations) # A primary REMOVE owns no active tool member. It can still retain the # same source-qualified section evidence only through its transient # direct-prism tool snapshot. primary = deepcopy(cdsl) primary["part_id"] = "primary-section-selector" primary["features"][1].update({ "id": "cut", "atomic_id": "extrude_cut_blind", "depends_on": ["left"], "params": {"distance_mm": 4}, }) primary["features"] = [primary["features"][0], primary["features"][1], primary["features"][3]] primary["features"][2]["depends_on"] = ["cut"] selector = primary["features"][2]["selectors"][0] selector["owner_feature_id"] = "cut" selector["selector_intent"]["intersection_sources"][1]["owner_feature_id"] = "cut" with tempfile.TemporaryDirectory() as directory: primary_result = rebuild_cdsl(primary, Path(directory) / "primary-section-selector.step") self.assertEqual(primary_result["feature_results"][-1]["feature_id"], "fillet") primary_delta = next( delta for delta in primary_result["topology_deltas"] if delta["feature_id"] == "cut" and delta["operation"] == "subtract" ) self.assertEqual(set(primary_delta["input_snapshot_ids"]), {"body:left", "transient:cut"}) self.assertTrue(any(relation.get("source_qualified") for relation in primary_delta["relations"])) self.assertTrue(any(record.get("transient") for record in primary_result["topology_records"])) def test_shell_offset_role_source_selects_one_exact_builder_relation(self) -> None: registry = TopologyRegistry() extrude_start = object() extrude_end = object() offset_start = object() offset_end = object() registry.replace_body_topology("extrude", "body:extrude", [ TopologyRecord( "extrude:start", "face", "extrude", "body:extrude", {"center_mm": [0, 0, 0]}, extrude_start, owner_feature_ids=("extrude",), output_roles=("extrude.start",), ), TopologyRecord( "extrude:end", "face", "extrude", "body:extrude", {"center_mm": [0, 0, 10]}, extrude_end, owner_feature_ids=("extrude",), output_roles=("extrude.end",), ), ]) registry.replace_body_topology("shell", "body:shell", [ TopologyRecord("shell:offset-start", "face", "shell", "body:shell", {"center_mm": [0, 0, 1]}, offset_start), TopologyRecord("shell:offset-end", "face", "shell", "body:shell", {"center_mm": [0, 0, 9]}, offset_end), ], topology_delta=TopologyDelta("shell", ( TopologyDeltaRelation("generated", "face", extrude_start, (offset_start,), output_role="shell.offset_face"), TopologyDeltaRelation("generated", "face", extrude_end, (offset_end,), output_role="shell.offset_face"), ))) ambiguous = registry.resolve({ "kind": "face", "owner_feature_id": "shell", "output_role": "shell.offset_face", }, active_body_id="body:shell") selected = registry.resolve({ "kind": "face", "owner_feature_id": "shell", "output_role": "shell.offset_face", "output_role_source": {"owner_feature_id": "extrude", "output_role": "extrude.start"}, }, active_body_id="body:shell") self.assertEqual(ambiguous.status, "ambiguous") self.assertEqual(selected.status, "resolved") self.assertEqual(selected.record.record_id, "shell:offset-start") self.assertEqual( selected.record.output_role_sources, (("shell.offset_face", "extrude", "extrude.start"),), ) def test_tapered_prism_exposes_builder_proven_single_cap_roles(self) -> None: from build123d import Face, Plane, Wire from cdsl_engine.build123d_adapter import Build123dGeometryAdapter face = Face(Wire.make_circle(10, Plane.XY)) result, delta = Build123dGeometryAdapter().extrude_taper_with_topology_delta( face, (0.0, 0.0, 20.0), 10.0, ) self.assertTrue(result.is_valid) self.assertGreater(result.volume, 0.0) self.assertIsNotNone(delta) self.assertEqual( [(relation.event, relation.kind, relation.output_role) for relation in delta.relations], [("generated", "face", "extrude.start"), ("generated", "face", "extrude.end")], ) def test_exact_kernel_history_crosses_a_boolean_member_index_shift(self) -> None: registry = TopologyRegistry() independent = object() tool = object() draft_cap = object() boolean_result_cap = object() registry.replace_body_topologies("draft", [ ("body:draft:0", [TopologyRecord( "draft:independent", "face", "independent", "body:draft:0", {"center_mm": [-5, 0, 0]}, independent, )]), ("body:draft:1", [TopologyRecord( "draft:tool", "face", "tool", "body:draft:1", {"center_mm": [0, 0, 0]}, tool, )]), ("body:draft:2", [TopologyRecord( "draft:cap", "face", "draft", "body:draft:2", {"center_mm": [5, 0, 0]}, draft_cap, owner_feature_ids=("draft",), output_roles=("extrude.start",), )]), ], active_body_id="body:draft") registry.replace_body_topologies("boolean", [ ("body:boolean:0", [TopologyRecord( "boolean:independent", "face", "boolean", "body:boolean:0", {"center_mm": [-5, 0, 0]}, independent, )]), ("body:boolean:1", [TopologyRecord( "boolean:cap", "face", "boolean", "body:boolean:1", {"center_mm": [5, 0, 0]}, boolean_result_cap, )]), ], active_body_id="body:boolean", topology_delta=TopologyDelta("subtract", ( TopologyDeltaRelation("modified", "face", draft_cap, (boolean_result_cap,)), ))) resolution = registry.resolve({ "kind": "face", "owner_feature_id": "draft", "output_role": "extrude.start", }, active_body_id="body:boolean") self.assertEqual(resolution.status, "resolved") self.assertEqual(resolution.record.record_id, "boolean:cap") self.assertEqual(resolution.record.owner_feature_ids, ("draft",)) self.assertEqual(resolution.record.output_roles, ("extrude.start",)) def test_output_role_semantic_contract_requires_face_runtime_evidence(self) -> None: from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() cdsl["features"][0]["execution_status"] = "supported" cdsl["features"].append({ "id": "shell", "atomic_id": "shell", "depends_on": ["base_add"], "params": {"thickness_mm": 1}, "execution_status": "supported", "selectors": [{ "kind": "face", "owner_feature_id": "base_add", "output_role": "sweep.end", "source": "runtime_snapshot", "confidence": 1, }], }) self.assertTrue(validate_semantic_cdsl(cdsl)["future_rebuild_ready"]) invalid = deepcopy(cdsl) invalid["features"][-1]["selectors"][0]["stable_id"] = "legacy-face" with self.assertRaisesRegex(ValueError, "cannot mix stable or geometry evidence"): validate_semantic_cdsl(invalid) nested = deepcopy(cdsl) nested["features"][-1]["selectors"][0]["matched_selectors"] = [{ "kind": "face", "owner_feature_id": "base_add", "output_role": "sweep.start", "source": "runtime_snapshot", "confidence": 1, }] with self.assertRaisesRegex(ValueError, "only supported in feature.selectors"): validate_semantic_cdsl(nested) bypassed_semantic_validation = deepcopy(cdsl) bypassed_semantic_validation["features"][-1]["params"]["role_reference"] = { "kind": "face", "owner_feature_id": "base_add", "output_role": "sweep.start", "source": "runtime_snapshot", "confidence": 1, } analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "shell"}, profile_types=SHAPE_GENERATORS, ).analyze(bypassed_semantic_validation) self.assertIn( "unsupported_output_role_selector_context", [blocker.code for blocker in analysis.feature_results[-1].blockers], ) malformed_source = deepcopy(cdsl) malformed_source["features"][-1]["selectors"][0]["output_role"] = "shell.offset_face" malformed_source["features"][-1]["selectors"][0]["output_role_source"] = {"owner_feature_id": "base_add"} with self.assertRaisesRegex(ValueError, "CDSL schema violation"): validate_semantic_cdsl(malformed_source) unsupported_source = deepcopy(cdsl) unsupported_source["features"][-1]["selectors"][0]["output_role"] = "shell.offset_face" unsupported_source["features"][-1]["selectors"][0]["output_role_source"] = { "owner_feature_id": "base_add", "output_role": "sweep.end", } with self.assertRaisesRegex(ValueError, "must be an extrude cap role"): validate_semantic_cdsl(unsupported_source) invalid_shell_target = deepcopy(cdsl) invalid_shell_target["features"][-1]["params"]["target_feature_id"] = "shell" with self.assertRaisesRegex(ValueError, "requires a preceding body feature"): validate_semantic_cdsl(invalid_shell_target) def test_up_to_surface_consumes_only_an_immediate_cap_output_role(self) -> None: from cdsl_engine.runtime import analyze_cdsl, rebuild_cdsl from cdsl_engine.semantic_validation import validate_semantic_cdsl cap_reference = { "kind": "face", "owner_feature_id": "base_add", "output_role": "extrude.end", "source": "runtime_snapshot", "confidence": 1.0, "selector_intent": { "version": "1.0", "kind": "face", "query_family": "CAP_FACE", "source_query": { "ast": {"call": "makeQuery"}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "derivation_policy": {"allowed": ["boundary", "continuation"], "multiplicity": "one"}, "evidence": "operation_role", "output_role": "extrude.end", }, } cdsl = self._base_block() cdsl["features"][0]["execution_status"] = "supported" cdsl["features"][0]["params"].update({ "result_mode": "new_body", "end_condition": {"type": "blind", "solidworks_code": 0}, }) cdsl["geometry"]["sketches"].append({ "id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }) cdsl["features"].append({ "id": "cut", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": { "distance_mm": 1, "end_condition": {"type": "up_to_surface", "solidworks_code": 2, "reference": cap_reference}, }, "sketch_id": "cut", "execution_status": "supported", }) self.assertTrue(validate_semantic_cdsl(cdsl)["future_rebuild_ready"]) self.assertTrue(analyze_cdsl(cdsl).feature_results[-1].executable) with tempfile.TemporaryDirectory() as directory: rebuilt = rebuild_cdsl(cdsl, Path(directory) / "up-to-surface-cap-role.step") resolution = next(item for item in rebuilt["selector_resolution"] if item["feature_id"] == "cut") self.assertEqual(resolution["status"], "resolved") self.assertEqual(resolution["resolution_mode"], "operation_role") self.assertEqual(resolution["selected"]["output_roles"], ["extrude.end"]) non_new_body = deepcopy(cdsl) non_new_body["features"][0]["params"]["result_mode"] = "fuse" with self.assertRaisesRegex(ValueError, "direct new_body or primary ADD blind extrusion cap"): validate_semantic_cdsl(non_new_body) self.assertIn( "unsupported_extent_output_role_selector", [blocker.code for blocker in analyze_cdsl(non_new_body).feature_results[-1].blockers], ) non_immediate = deepcopy(cdsl) non_immediate["features"].insert(1, { "id": "gap", "atomic_id": "reference_plane", "depends_on": ["base_add"], "params": {"plane": _workplane()}, "execution_status": "supported", }) non_immediate["features"][-1]["depends_on"] = ["gap"] with self.assertRaisesRegex(ValueError, "immediately preceding direct new_body or primary ADD blind extrusion cap"): validate_semantic_cdsl(non_immediate) self.assertIn( "unsupported_extent_output_role_selector", [blocker.code for blocker in analyze_cdsl(non_immediate).feature_results[-1].blockers], ) def test_shell_consumes_only_an_immediate_direct_cap_output_role(self) -> None: from cdsl_engine.runtime import analyze_cdsl, rebuild_cdsl from cdsl_engine.semantic_validation import validate_semantic_cdsl cap_selector = { "kind": "face", "owner_feature_id": "base_add", "output_role": "extrude.end", "source": "runtime_snapshot", "confidence": 1.0, "selector_intent": { "version": "1.0", "kind": "face", "query_family": "CAP_FACE", "source_query": { "ast": {"call": "makeQuery"}, "featurescript_version": "1511", "standard_library": "onshape/std/geometry.fs", "standard_library_version": "1511.0", }, "derivation_policy": {"allowed": ["boundary", "continuation"], "multiplicity": "one"}, "evidence": "operation_role", "output_role": "extrude.end", }, } cdsl = self._base_block() cdsl["features"][0]["execution_status"] = "supported" cdsl["features"][0]["params"].update({ "result_mode": "new_body", "end_condition": {"type": "blind", "solidworks_code": 0}, }) cdsl["features"].append({ "id": "shell", "atomic_id": "shell", "depends_on": ["base_add"], "params": {"thickness_mm": 1, "inward": True}, "selectors": [cap_selector], "execution_status": "supported", }) self.assertTrue(validate_semantic_cdsl(cdsl)["future_rebuild_ready"]) self.assertTrue(analyze_cdsl(cdsl).feature_results[-1].executable) with tempfile.TemporaryDirectory() as directory: rebuilt = rebuild_cdsl(cdsl, Path(directory) / "cap-role-shell.step") resolution = next(item for item in rebuilt["selector_resolution"] if item["feature_id"] == "shell") self.assertEqual(resolution["status"], "resolved") self.assertEqual(resolution["resolution_mode"], "operation_role") self.assertEqual(resolution["selected"]["output_roles"], ["extrude.end"]) non_immediate = deepcopy(cdsl) non_immediate["features"].insert(1, { "id": "gap", "atomic_id": "reference_plane", "depends_on": ["base_add"], "params": {"plane": _workplane()}, "execution_status": "supported", }) non_immediate["features"][-1]["depends_on"] = ["gap"] with self.assertRaisesRegex(ValueError, "CAP_FACE output role requires the immediately preceding direct new_body blind extrusion cap"): validate_semantic_cdsl(non_immediate) self.assertIn( "unsupported_cap_face_output_role_selector", [blocker.code for blocker in analyze_cdsl(non_immediate).feature_results[-1].blockers], ) def test_transformed_owner_selector_executes_a_downstream_fillet(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["features"].append({ "id": "move", "atomic_id": "transform_bodies", "depends_on": ["base_add"], "params": { "source_feature_ids": ["base_add"], "transform": {"type": "translation", "translation_mm": [20, 0, 0]}, "make_copy": False, }, }) with tempfile.TemporaryDirectory() as directory: root = Path(directory) moved = rebuild_cdsl(cdsl, root / "moved.step") edge = next( item for item in moved["topology_records"] if item["kind"] == "edge" and item.get("body_id") == "body:move" ) filleted = deepcopy(cdsl) filleted["features"].append({ "id": "fillet", "atomic_id": "fillet", "depends_on": ["move"], "params": {"radius_mm": 1}, "selectors": [{ "kind": "edge", "stable_id": "moved-edge", "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": edge["geometry"], }], }) result = rebuild_cdsl(filleted, root / "filleted.step") self.assertEqual([item["feature_id"] for item in result["feature_results"]], ["base_add", "move", "fillet"]) self.assertLess(result["volume_mm3"], moved["volume_mm3"]) self.assertTrue(any( item["operation"] == "translation" for item in result["topology_deltas"] )) def test_body_transform_unavailable_source_is_a_preflight_diagnostic(self) -> None: cdsl = self._base_block() cdsl["features"].append({ "id": "move", "atomic_id": "transform_bodies", "depends_on": ["base_add"], "params": { "source_feature_ids": ["missing_body"], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": True, }, }) analysis = CapabilityAnalyzer(atomic_ids={"extrude_add_blind", "transform_bodies"}, profile_types=SHAPE_GENERATORS).analyze(cdsl) blocker = next(item for item in analysis.feature_results[-1].blockers if item.code == "body_source_unavailable") self.assertEqual(blocker.code, "body_source_unavailable") self.assertEqual(blocker.detail, {"source_feature_id": "missing_body"}) def test_absorbed_body_source_is_not_selectable_after_a_fused_feature(self) -> None: cdsl = self._base_block() cdsl["features"].extend([ { "id": "fused_add", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "params": {"distance_mm": 5}, "sketch_id": "base", }, { "id": "move", "atomic_id": "transform_bodies", "depends_on": ["fused_add"], "params": { "source_feature_ids": ["base_add"], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": True, }, }, ]) analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "transform_bodies"}, profile_types=SHAPE_GENERATORS, ).analyze(cdsl) blocker = next(item for item in analysis.feature_results[-1].blockers if item.code == "body_source_unavailable") self.assertEqual(blocker.detail, {"source_feature_id": "base_add"}) def test_boolean_consumed_body_source_is_not_selectable_afterward(self) -> None: cdsl = self._base_block() cdsl["features"][0]["params"]["result_mode"] = "new_body" cdsl["features"].extend([ { "id": "tool_body", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "params": {"distance_mm": 5, "result_mode": "new_body"}, "sketch_id": "base", }, { "id": "join", "atomic_id": "boolean_bodies", "depends_on": ["base_add", "tool_body"], "params": { "operation": "union", "target_feature_ids": ["base_add"], "tool_feature_ids": ["tool_body"], "keep_tools": False, }, }, { "id": "move", "atomic_id": "transform_bodies", "depends_on": ["join"], "params": { "source_feature_ids": ["base_add"], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": True, }, }, ]) analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "boolean_bodies", "transform_bodies"}, profile_types=SHAPE_GENERATORS, ).analyze(cdsl) blocker = next(item for item in analysis.feature_results[-1].blockers if item.code == "body_source_unavailable") self.assertEqual(blocker.detail, {"source_feature_id": "base_add"}) def test_boolean_rejects_a_body_source_absorbed_by_a_fused_feature(self) -> None: cdsl = self._base_block() cdsl["features"].extend([ { "id": "fused_add", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "params": {"distance_mm": 5}, "sketch_id": "base", }, { "id": "selected_tool", "atomic_id": "extrude_add_blind", "depends_on": ["fused_add"], "params": {"distance_mm": 3, "result_mode": "new_body"}, "sketch_id": "base", }, { "id": "boolean", "atomic_id": "boolean_bodies", "depends_on": ["selected_tool"], "params": { "operation": "subtract", "target_feature_ids": ["base_add"], "tool_feature_ids": ["selected_tool"], "keep_tools": False, }, }, ]) analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "boolean_bodies"}, profile_types=SHAPE_GENERATORS, ).analyze(cdsl) blocker = next(item for item in analysis.feature_results[-1].blockers if item.code == "boolean_body_unavailable") self.assertEqual(blocker.detail, {"source_feature_id": "base_add"}) def test_deleted_last_body_clears_the_active_body_precondition(self) -> None: cdsl = self._base_block() cdsl["features"].extend([ { "id": "delete_base", "atomic_id": "delete_bodies", "depends_on": ["base_add"], "params": {"target_feature_ids": ["base_add"]}, }, { "id": "cut_after_delete", "atomic_id": "extrude_cut_blind", "depends_on": ["delete_base"], "params": {"distance_mm": 1}, "sketch_id": "base", }, ]) analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "extrude_cut_blind", "delete_bodies"}, profile_types=SHAPE_GENERATORS, ).analyze(cdsl) blockers = {item.code for item in analysis.feature_results[-1].blockers} self.assertIn("missing_active_body", blockers) def test_pattern_replay_does_not_make_its_source_a_body_member(self) -> None: cdsl = self._base_block() cdsl["features"].extend([ { "id": "array", "atomic_id": "pattern_linear", "depends_on": ["base_add"], "params": { "source_feature_ids": ["base_add"], "direction_1": [1, 0, 0], "spacing_1_mm": 20, "pattern_count_1": 2, }, }, { "id": "move", "atomic_id": "transform_bodies", "depends_on": ["array"], "params": { "source_feature_ids": ["base_add"], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": True, }, }, ]) analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "pattern_linear", "transform_bodies"}, profile_types=SHAPE_GENERATORS, ).analyze(cdsl) blocker = next(item for item in analysis.feature_results[-1].blockers if item.code == "body_source_unavailable") self.assertEqual(blocker.detail, {"source_feature_id": "base_add"}) def test_deferred_reference_is_currently_executable_without_a_sketch(self) -> None: cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{"id": "s", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 1}}]}, "features": [{ "id": "plane", "atomic_id": "reference_plane", "depends_on": [], "execution_status": "deferred", "params": {"plane": _workplane()}, }], } analysis = CapabilityAnalyzer(atomic_ids={"reference_plane"}, profile_types=SHAPE_GENERATORS).analyze(cdsl) self.assertFalse(analysis.runtime_eligible) self.assertEqual(analysis.feature_results[0].resolved_status, "executable") self.assertEqual(analysis.document_blockers[0].code, "no_solid_feature") def test_reference_point_is_non_mutating_and_requires_finite_coordinates(self) -> None: from cdsl_engine.runtime import analyze_cdsl, prepare_cdsl_execution cdsl = self._base_block() cdsl["features"].append({ "id": "datum", "atomic_id": "reference_point", "depends_on": ["base_add"], "params": {"point_mm": [1.0, 2.0, 3.0]}, }) execution = prepare_cdsl_execution(cdsl) base = execution.execute_next() point = execution.execute_next() self.assertEqual(base.status, "executed") self.assertEqual(point.status, "executed") self.assertIsNone(point.body_id) self.assertEqual(execution.session.body_id, "body:base_add") invalid = deepcopy(cdsl) invalid["features"][-1]["params"]["point_mm"] = [0.0, math.nan, 0.0] analysis = analyze_cdsl(invalid) datum = next(item for item in analysis.feature_results if item.feature_id == "datum") self.assertIn("invalid_reference_point", [item.code for item in datum.blockers]) def test_assign_variable_is_non_mutating_and_rejects_nonfinite_values(self) -> None: from cdsl_engine.runtime import analyze_cdsl, prepare_cdsl_execution from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() for feature in cdsl["features"]: feature["execution_status"] = "supported" cdsl["features"].append({ "id": "thickness", "atomic_id": "assign_variable", "depends_on": ["base_add"], "params": {"name": "thickness", "value": 4.0, "value_kind": "any"}, "execution_status": "supported", }) validate_semantic_cdsl(cdsl) execution = prepare_cdsl_execution(cdsl) base = execution.execute_next() variable = execution.execute_next() self.assertEqual(base.status, "executed") self.assertEqual(variable.status, "executed") self.assertIsNone(variable.body_id) self.assertEqual(execution.session.body_id, "body:base_add") self.assertFalse(any(record.feature_id == "thickness" for record in execution.session.topology.records())) invalid = deepcopy(cdsl) invalid["features"][-1]["params"]["value"] = math.nan analysis = analyze_cdsl(invalid) assignment = next(item for item in analysis.feature_results if item.feature_id == "thickness") self.assertIn("invalid_assign_variable", [item.code for item in assignment.blockers]) with self.assertRaisesRegex(ValueError, "finite scalar value"): validate_semantic_cdsl(invalid) duplicate = deepcopy(cdsl) duplicate["features"].append({ "id": "thickness_again", "atomic_id": "assign_variable", "depends_on": ["thickness"], "params": {"name": "thickness", "value": 5.0, "value_kind": "any"}, "execution_status": "supported", }) with self.assertRaisesRegex(ValueError, "redeclares source variable thickness"): validate_semantic_cdsl(duplicate) def test_unused_invalid_profile_does_not_block_runtime_preflight(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "abandoned", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [{"type": "line", "start": [0, 0], "end": [1, 0]}], }]}, }) analysis = analyze_cdsl(cdsl) self.assertTrue(analysis.runtime_eligible) def test_used_invalid_profile_is_a_feature_level_blocker(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "broken", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [{"type": "line", "start": [0, 0], "end": [1, 0]}], }]}, }) cdsl["features"].append({ "id": "broken_cut", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 1}, "sketch_id": "broken", }) analysis = analyze_cdsl(cdsl) broken = next(item for item in analysis.feature_results if item.feature_id == "broken_cut") self.assertEqual(broken.resolved_status, "blocked") self.assertIn("profile_resolution_failed", [item.code for item in broken.blockers]) def test_used_empty_analytic_profile_is_a_feature_level_blocker(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "construction_only", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": []}, }) cdsl["features"].append({ "id": "empty_cut", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 1}, "sketch_id": "construction_only", }) analysis = analyze_cdsl(cdsl) empty = next(item for item in analysis.feature_results if item.feature_id == "empty_cut") self.assertIn("profile_no_closed_region", [item.code for item in empty.blockers]) def test_selector_resolver_refuses_equal_candidates(self) -> None: registry = TopologyRegistry() plane = PlaneSpec.from_mapping(_workplane()) registry.register(TopologyRecord("first", "plane", "f1", geometry=plane.as_dict(), value=plane)) registry.register(TopologyRecord("second", "plane", "f2", geometry=plane.as_dict(), value=plane)) resolution = registry.resolve({"kind": "plane", "geometry": plane.as_dict()}) self.assertEqual(resolution.status, "ambiguous") self.assertEqual(resolution.diagnostic.code, "selector_ambiguous") def test_selector_resolver_prefers_exact_runtime_stable_id(self) -> None: registry = TopologyRegistry() geometry = {"curve_type": "circle", "center_mm": [0, 0, 0]} registry.register(TopologyRecord("body:b:edge:18", "edge", "boss", "body:b", geometry)) registry.register(TopologyRecord("body:b:edge:20", "edge", "boss", "body:b", geometry)) resolution = registry.resolve({ "kind": "edge", "stable_id": "body:b:edge:18", "owner_feature_id": "boss", "snapshot_id": "cad_test/rev_001", "geometry": geometry, }, active_body_id="body:b") self.assertEqual(resolution.status, "resolved") self.assertEqual(resolution.record.record_id, "body:b:edge:18") def test_snapshot_stable_id_rejects_geometry_that_changed(self) -> None: registry = TopologyRegistry() registry.register(TopologyRecord( "body:b:edge:18", "edge", "boss", "body:b", {"curve_type": "circle", "center_mm": [0, 0, 0]}, )) resolution = registry.resolve({ "kind": "edge", "stable_id": "body:b:edge:18", "owner_feature_id": "boss", "snapshot_id": "cad_test/rev_001", "geometry": {"curve_type": "circle", "center_mm": [1, 0, 0]}, }, active_body_id="body:b") self.assertEqual(resolution.status, "not_found") self.assertEqual(resolution.diagnostic.code, "selector_geometry_mismatch") def test_selector_resolver_normalizes_legacy_solidworks_plane_evidence(self) -> None: registry = TopologyRegistry() registry.register(TopologyRecord( "face", "face", "f1", "body:f1", geometry={ "surface_type": "plane", "plane_normal": [1, 0, 0], "plane_offset_mm": 12.0, "bbox_mm": [12, -2, -3, 12, 2, 3], "area_mm2": 24, }, )) resolution = registry.resolve({ "kind": "face", "geometry": { "surface": {"type": "plane", "parameters": [-1, 0, 0, -0.012, 0, 0]}, "box": [0.012, -0.002, -0.003, 0.012, 0.002, 0.003], "area": 0.000024, }, }) self.assertEqual(resolution.status, "resolved") self.assertEqual(resolution.record.record_id, "face") def test_owner_selector_survives_a_later_body_snapshot_when_geometry_is_unchanged(self) -> None: registry = TopologyRegistry() geometry = { "bbox_mm": [0, 0, 0, 0, 0, 10], "center_mm": [0, 0, 5], "length_mm": 10.0, "curve_type": "line", "start_mm": [0, 0, 0], "end_mm": [0, 0, 10], } registry.replace_body_topology("base_add", "body:base_add", [ TopologyRecord("body:base_add:edge:0", "edge", "base_add", "body:base_add", geometry, "old-edge"), ]) registry.replace_body_topology("later_cut", "body:later_cut", [ TopologyRecord("body:later_cut:edge:3", "edge", "later_cut", "body:later_cut", geometry, "current-edge"), ]) resolution = registry.resolve( {"kind": "edge", "owner_feature_id": "base_add", "geometry": geometry}, active_body_id="body:later_cut", ) self.assertEqual(resolution.status, "resolved") self.assertEqual(resolution.record.value, "current-edge") self.assertEqual(resolution.record.feature_id, "later_cut") self.assertEqual(resolution.record.owner_feature_ids, ("base_add",)) def test_ambiguous_predecessors_do_not_invent_topology_ownership(self) -> None: registry = TopologyRegistry() geometry = {"center_mm": [1, 2, 3]} registry.replace_body_topology("base_add", "body:base_add", [ TopologyRecord("body:base_add:vertex:0", "vertex", "base_add", "body:base_add", geometry), TopologyRecord("body:base_add:vertex:1", "vertex", "base_add", "body:base_add", geometry), ]) registry.replace_body_topology("later_cut", "body:later_cut", [ TopologyRecord("body:later_cut:vertex:0", "vertex", "later_cut", "body:later_cut", geometry), ]) resolution = registry.resolve( {"kind": "vertex", "owner_feature_id": "base_add", "geometry": geometry}, active_body_id="body:later_cut", ) self.assertEqual(resolution.status, "not_found") def test_changed_adjacency_prevents_owner_provenance_transfer(self) -> None: registry = TopologyRegistry() unchanged_geometry = { "bbox_mm": [0, 0, 0, 1, 1, 0], "center_mm": [0.5, 0.5, 0], "normal": [0, 0, 1], "area_mm2": 1, "surface_type": "plane", } registry.replace_body_topology("base_add", "body:base_add", [ TopologyRecord( "body:base_add:face:0", "face", "base_add", "body:base_add", {**unchanged_geometry, "adjacency_signature": ["line:1.000000:2"]}, ), ]) registry.replace_body_topology("later_cut", "body:later_cut", [ TopologyRecord( "body:later_cut:face:0", "face", "later_cut", "body:later_cut", {**unchanged_geometry, "adjacency_signature": ["line:1.000000:2", "circle:1.000000:1"]}, ), ]) resolution = registry.resolve( {"kind": "face", "owner_feature_id": "base_add", "geometry": unchanged_geometry}, active_body_id="body:later_cut", ) self.assertEqual(resolution.status, "not_found") def test_batch_analysis_writes_one_report_per_input(self) -> None: document = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "batch-part", "meta": {"unit": "mm"}, "geometry": {"sketches": [{"id": "s", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 1}}]}, "features": [{ "id": "f", "atomic_id": "reference_plane", "depends_on": [], "execution_status": "deferred", "params": {"plane": _workplane()}, }], } with tempfile.TemporaryDirectory() as directory: root = Path(directory) input_path = root / "input" input_path.mkdir() (input_path / "batch-part.cdsl.json").write_text(json.dumps(document), encoding="utf-8") manifest = batch_analyze(input_path, root / "out", atomic_ids=frozenset({"reference_plane"})) report = json.loads((root / "out" / "parts" / "batch-part.report.json").read_text(encoding="utf-8")) self.assertEqual(manifest["part_count"], 1) self.assertTrue(report["semantic_valid"]) self.assertFalse(report["runtime_eligible"]) self.assertEqual(report["first_blocker"]["code"], "no_solid_feature") def test_batch_analysis_part_filter_is_exact_and_rejects_unknown_ids(self) -> None: document = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "meta": {"unit": "mm"}, "geometry": {"sketches": []}, "features": [], } with tempfile.TemporaryDirectory() as directory: root = Path(directory) input_path = root / "input" input_path.mkdir() for part_id in ("first", "second"): (input_path / f"{part_id}.cdsl.json").write_text( json.dumps({**document, "part_id": part_id}), encoding="utf-8", ) manifest = batch_analyze( input_path, root / "out", atomic_ids=frozenset({"reference_plane"}), part_ids=["second"], ) self.assertEqual(manifest["part_count"], 1) self.assertEqual(manifest["results"], [{"part_id": "second", "report": "parts/second.report.json"}]) with self.assertRaisesRegex(ValueError, "do not exist"): batch_analyze(input_path, root / "bad", part_ids=["missing"]) def test_batch_resume_migrates_derived_failure_category_without_rebuilding(self) -> None: document = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "cached", "meta": {"unit": "mm"}, "geometry": {"sketches": []}, "features": [], } with tempfile.TemporaryDirectory() as directory: root = Path(directory) source = root / "input" source.mkdir() (source / "cached.cdsl.json").write_text(json.dumps(document), encoding="utf-8") report_path = root / "out" / "parts" / "cached.report.json" report_path.parent.mkdir(parents=True) report_path.write_text(json.dumps({ "part_id": "cached", "semantic_valid": True, "runtime_eligible": False, "compiled": False, "build_attempted": False, "built": False, "geometry_verified": False, "feature_results": [], "first_blocker": {"code": "missing_host_face"}, }), encoding="utf-8") manifest = batch_analyze(source, root / "out") report = json.loads(report_path.read_text(encoding="utf-8")) self.assertEqual(manifest["failure_category_counts"], {"input_incomplete": 1}) self.assertEqual(report["failure_category"], "input_incomplete") def test_full_export_batch_has_a_machine_readable_report_for_every_input(self) -> None: """Keep the shipped CDSL corpus on the capability-report path. STEP construction is intentionally left to the resumable build job; this CI-sized pass proves that every current export gets a semantic result and a first blocker rather than being silently skipped. """ source = ROOT / "json_to_cdsl" / "output" selectors = [path.name.removesuffix(".cdsl.json") for path in sorted(source.glob("*.cdsl.json"))] corpus = _corpus_manifest(source) input_count = len(selectors) self.assertGreater(input_count, 0) self.assertEqual(input_count, corpus["document_count"]) self.assertEqual(_selector_digest(selectors), corpus["document_stems_sha256"]) with tempfile.TemporaryDirectory() as directory: out = Path(directory) / "baseline" manifest = batch_analyze(source, out) reports = [json.loads(path.read_text(encoding="utf-8")) for path in (out / "parts").glob("*.report.json")] self.assertEqual(manifest["part_count"], input_count) self.assertEqual(manifest["completed_count"], input_count) self.assertTrue(manifest["complete"]) self.assertEqual(manifest["semantic_valid_count"], input_count) self.assertEqual(len(reports), input_count) self.assertTrue(all(report["runtime_eligible"] or report.get("first_blocker") for report in reports)) def test_p3_static_pool_is_explicit_and_reports_missing_capture_separately(self) -> None: from cdsl_engine.phase_pools import select_p3_static_pool from cdsl_engine.runtime import analyze_cdsl source = ROOT / "json_to_cdsl" / "output" part_ids = select_p3_static_pool(source) expected = _corpus_manifest(source)["phase_pools"]["p3"] self.assertEqual(len(part_ids), expected["selector_count"]) self.assertEqual(_selector_digest(part_ids), expected["selectors_sha256"]) # Static pool membership is input-based. Runtime preflight remains a # separate signal and must retain captured blockers for its members. expected_blockers = { "027784": {"missing_revolve_axis"}, "104237": {"missing_extent_reference"}, "239358": {"missing_extent_reference", "dependency_unavailable"}, "241720": {"missing_extent_reference"}, } for part_id, blockers in expected_blockers.items(): self.assertIn(part_id, part_ids) cdsl = json.loads((source / f"{part_id}.cdsl.json").read_text(encoding="utf-8")) result = analyze_cdsl(cdsl) actual = { blocker.code for feature in result.feature_results for blocker in feature.blockers } self.assertTrue(blockers <= actual) def test_p3_phase_pool_can_be_passed_to_batch_rebuild(self) -> None: from cdsl_engine.phase_pools import select_p3_static_pool source = ROOT / "json_to_cdsl" / "output" pool = select_p3_static_pool(source) self.assertIn("Bearing-Spacer-1", pool) with tempfile.TemporaryDirectory() as directory: manifest = batch_analyze(source, Path(directory) / "p3", part_ids=pool, max_parts=1) self.assertEqual(manifest["part_count"], len(pool)) self.assertEqual(manifest["completed_count"], 1) self.assertFalse(manifest["complete"]) def test_phase_pool_membership_is_regressed_for_p4_and_p6(self) -> None: from cdsl_engine.phase_pools import select_static_phase_pool source = ROOT / "json_to_cdsl" / "output" expected_pools = _corpus_manifest(source)["phase_pools"] for phase in ("p4", "p6"): selectors = select_static_phase_pool(source, phase) expected = expected_pools[phase] self.assertEqual(len(selectors), expected["selector_count"]) self.assertEqual(_selector_digest(selectors), expected["selectors_sha256"]) with self.assertRaisesRegex(ValueError, "Unknown CDSL runtime phase"): select_static_phase_pool(source, "p5") def test_construction_bspline_is_auditable_but_not_an_executable_contour(self) -> None: from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() cdsl["features"][0]["execution_status"] = "supported" profile = { "type": "analytic_contours", "contours": [{ "role": "outer", "closed": True, "segments": [ {"type": "line", "start": [-5, -5], "end": [5, -5]}, {"type": "line", "start": [5, -5], "end": [5, 5]}, {"type": "line", "start": [5, 5], "end": [-5, 5]}, {"type": "line", "start": [-5, 5], "end": [-5, -5]}, ], }], "construction": [{ "type": "bspline", "degree": 2, "control_points": [[-5, 0], [0, 2], [5, 0]], "knots": [0, 0, 0, 1, 1, 1], "periodic": False, }], } cdsl["geometry"]["sketches"][0]["profile"] = profile validate_semantic_cdsl(cdsl) resolved = resolve_all_sketches(cdsl) entities = resolved["geometry"]["sketches"][0]["entities"] self.assertNotIn("bspline", {entity["type"] for entity in entities}) profile["contours"][0]["segments"][0] = profile["construction"][0] with self.assertRaisesRegex(ValueError, "CDSL schema violation"): validate_semantic_cdsl(cdsl) def test_nested_pattern_source_is_replayable_after_its_first_execution(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["features"].extend([ { "id": "first_pattern", "atomic_id": "pattern_linear", "depends_on": ["base_add"], "params": {"source_feature_ids": ["base_add"], "direction_1": [1, 0, 0], "spacing_1_mm": 20, "pattern_count_1": 2}, }, { "id": "nested_pattern", "atomic_id": "pattern_linear", "depends_on": ["first_pattern"], "params": {"source_feature_ids": ["first_pattern"], "direction_1": [0, 1, 0], "spacing_1_mm": 20, "pattern_count_1": 2}, }, ]) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "nested.step") self.assertEqual(result["engine"], "cdsl_session_runtime") def test_pattern_source_without_body_definition_is_blocked_in_preflight(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["features"].insert(0, { "id": "context", "atomic_id": "reference_plane", "depends_on": [], "params": {"plane": _workplane()}, }) cdsl["features"].append({ "id": "pattern", "atomic_id": "pattern_linear", "depends_on": ["base_add", "context"], "params": {"source_feature_ids": ["context"], "direction_1": [1, 0, 0], "spacing_1_mm": 20, "pattern_count_1": 2}, }) analysis = analyze_cdsl(cdsl) pattern = next(result for result in analysis.feature_results if result.feature_id == "pattern") self.assertEqual(pattern.resolved_status, "unsupported") self.assertIn("unsupported_pattern_source", [blocker.code for blocker in pattern.blockers]) def test_truth_comparison_keeps_frame_mismatch_distinct_from_verified_geometry(self) -> None: truth = {"bounding_box_mm": [-10, -200, -10, 10, 200, 10], "solid_count": 1} common = { "truth": truth, "volume_relative_error": 1e-8, "area_relative_error": 1e-8, "solid_count_matches": True, } self.assertEqual( _verification_classification( actual_box=[-10, 990, 0, 10, 1010, 400], box_delta=1190, **common, ), "coordinate_frame_mismatch_candidate", ) self.assertEqual( _verification_classification( actual_box=[-10, -200, -10, 10, 200, 10], box_delta=0, **common, ), "verified", ) self.assertEqual( _verification_classification( actual_box=[-10, 990, 0, 10, 1010, 400], box_delta=1190, truth=truth, volume_relative_error=0.1, area_relative_error=1e-8, solid_count_matches=True, ), "geometry_mismatch", ) def test_batch_failure_categories_preserve_input_selector_capability_and_occ_boundaries(self) -> None: self.assertEqual(_failure_category({"geometry_verified": True}), "geometry_verified") self.assertEqual(_failure_category({"runtime_eligible": True, "build_attempted": False}), "runtime_eligible_not_built") self.assertEqual(_failure_category({"built": True, "numeric_comparison": {"classification": "coordinate_frame_mismatch_candidate"}}), "coordinate_frame_mismatch_candidate") self.assertEqual(_failure_category({"built": False, "first_blocker": {"code": "missing_host_face"}}), "input_incomplete") self.assertEqual(_failure_category({"built": False, "first_blocker": {"code": "extent_target_not_reached"}}), "input_incomplete") self.assertEqual(_failure_category({"built": False, "first_blocker": {"code": "selector_ambiguous"}}), "selector_resolution") self.assertEqual(_failure_category({"built": False, "first_blocker": {"code": "unsupported_hole_subtype"}}), "unsupported_capability") self.assertEqual(_failure_category({"built": False, "first_blocker": {"code": "build_timeout"}}), "occ_execution_failure") def test_mirror_pattern_replays_a_selector_free_cut(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "mirror-test", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "base", "workplane": _workplane(), "profile": _rectangle([-5, -5], [5, 5])}, {"id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [2, 0], "radius_mm": 1}}, ]}, "features": [ {"id": "ref", "atomic_id": "reference_plane", "depends_on": [], "params": {"plane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]}}}, {"id": "base_add", "atomic_id": "extrude_add_blind", "depends_on": ["ref"], "params": {"distance_mm": 2}, "sketch_id": "base"}, {"id": "cut_1", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 2}, "sketch_id": "cut"}, { "id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["cut_1", "ref"], "params": {"source_feature_ids": ["cut_1"], "mirror_plane": {"kind": "plane", "stable_id": "source", "source": "solidworks", "confidence": 1, "owner_feature_id": "ref"}}, "selectors": [{"kind": "plane", "stable_id": "source", "source": "solidworks", "confidence": 1, "owner_feature_id": "ref"}], }, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "mirror.step") self.assertAlmostEqual(result["volume_mm3"], 200 - 4 * 3.141592653589793, places=5) self.assertIn("mirror", [item["feature_id"] for item in result["feature_results"]]) def test_circular_pattern_fuses_face_sharing_new_body_instances(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "circular-fuse", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "wedge", "workplane": _workplane(), "profile": {"type": "polygon", "vertices": [[0, 0], [10, 0], [0, 10]]}, }]}, "features": [ {"id": "wedge_add", "atomic_id": "extrude_add_blind", "depends_on": [], "params": {"distance_mm": 10, "result_mode": "new_body"}, "sketch_id": "wedge"}, {"id": "wedge_pattern", "atomic_id": "pattern_circular", "depends_on": ["wedge_add"], "params": { "source_feature_ids": ["wedge_add"], "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "pattern_count": 4, "sweep_angle_deg": 360, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "circular-fuse.step") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], 2000.0, places=5) copy_owners = { owner for record in result["topology_records"] for owner in record.get("owner_feature_ids") or () if owner.startswith("wedge_pattern.c") } self.assertEqual( copy_owners, { "wedge_pattern.c1.wedge_add", "wedge_pattern.c2.wedge_add", "wedge_pattern.c3.wedge_add", }, ) def test_circular_pattern_skips_explicitly_deleted_copy_instances(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "circular-delete-copy", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "wedge", "workplane": _workplane(), "profile": {"type": "polygon", "vertices": [[0, 0], [10, 0], [0, 10]]}, }]}, "features": [ {"id": "wedge_add", "atomic_id": "extrude_add_blind", "depends_on": [], "params": {"distance_mm": 10, "result_mode": "new_body"}, "sketch_id": "wedge"}, {"id": "wedge_pattern", "atomic_id": "pattern_circular", "depends_on": ["wedge_add"], "params": { "source_feature_ids": ["wedge_add"], "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "pattern_count": 4, "sweep_angle_deg": 360, "excluded_instance_indices": [2], }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "circular-delete-copy.step") self.assertAlmostEqual(result["volume_mm3"], 1500.0, places=5) def test_transform_can_move_one_proven_circular_pattern_copy(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "circular-copy-transform", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "boss", "workplane": _workplane(), "profile": {"type": "circle", "center": [10, 0], "radius_mm": 1}, }]}, "features": [ {"id": "boss_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "boss", "params": {"distance_mm": 2, "result_mode": "new_body"}}, {"id": "boss_pattern", "atomic_id": "pattern_circular", "depends_on": ["boss_add"], "params": { "source_feature_ids": ["boss_add"], "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "pattern_count": 4, "sweep_angle_deg": 360, }}, {"id": "move_copy", "atomic_id": "transform_bodies", "depends_on": ["boss_pattern"], "params": { "pattern_instance_refs": [{"pattern_feature_id": "boss_pattern", "source_feature_id": "boss_add", "instance_index": 1}], "transform": {"type": "translation", "translation_mm": [40, 0, 0]}, "make_copy": False, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "circular-copy-transform.step") self.assertEqual(result["solid_count"], 4) self.assertAlmostEqual(result["volume_mm3"], 4 * math.pi * 2, places=5) self.assertEqual(result["bbox_mm"]["max"], [41.0, 11.0, 2.0]) self.assertEqual([item["feature_id"] for item in result["feature_results"]], ["boss_add", "boss_pattern", "move_copy"]) def test_boolean_can_union_copies_of_a_proven_fused_body_successor(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "fused-body-pattern-boolean", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "base", "workplane": _workplane(), "profile": {"type": "circle", "center": [10, 0], "radius_mm": 2}}, {"id": "boss", "workplane": _workplane(), "profile": {"type": "circle", "center": [12, 0], "radius_mm": 1.5}}, ]}, "features": [ {"id": "base_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "base", "params": {"distance_mm": 2, "result_mode": "new_body"}}, {"id": "boss_add", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "sketch_id": "boss", "params": {"distance_mm": 2}}, {"id": "boss_pattern", "atomic_id": "pattern_circular", "depends_on": ["boss_add"], "params": { "source_feature_ids": ["boss_add"], "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "pattern_count": 3, "sweep_angle_deg": 360, }}, {"id": "join", "atomic_id": "boolean_bodies", "depends_on": ["boss_pattern"], "params": { "operation": "union", "target_feature_ids": ["boss_add"], "tool_pattern_instance_refs": [ {"pattern_feature_id": "boss_pattern", "source_feature_id": "boss_add", "instance_index": 1}, {"pattern_feature_id": "boss_pattern", "source_feature_id": "boss_add", "instance_index": 2}, ], "keep_tools": False, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "fused-body-pattern-boolean.step") self.assertEqual(result["solid_count"], 3) self.assertEqual([item["feature_id"] for item in result["feature_results"]], [ "base_add", "boss_add", "boss_pattern", "join", ]) def test_transform_can_move_one_proven_mirror_pattern_copy(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "mirror-copy-transform", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "boss", "workplane": _workplane(), "profile": {"type": "circle", "center": [10, 0], "radius_mm": 1}, }]}, "features": [ {"id": "mirror_plane", "atomic_id": "reference_plane", "depends_on": [], "params": { "plane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]}, }}, {"id": "boss_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "boss", "params": { "distance_mm": 2, "result_mode": "new_body", }}, {"id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["boss_add", "mirror_plane"], "params": { "source_feature_ids": ["boss_add"], "mirror_current_body": True, "mirror_plane": {"kind": "plane", "owner_feature_id": "mirror_plane"}, }, "selectors": [{"kind": "plane", "owner_feature_id": "mirror_plane"}]}, {"id": "move_copy", "atomic_id": "transform_bodies", "depends_on": ["mirror"], "params": { "pattern_instance_refs": [{"pattern_feature_id": "mirror", "source_feature_id": "boss_add", "instance_index": 1}], "transform": {"type": "translation", "translation_mm": [0, 20, 0]}, "make_copy": False, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "mirror-copy-transform.step") self.assertEqual(result["solid_count"], 2) self.assertAlmostEqual(result["volume_mm3"], 4 * math.pi, places=5) self.assertEqual(result["bbox_mm"], {"min": [-11.0, -1.0, 0.0], "max": [11.0, 21.0, 2.0]}) self.assertEqual([item["feature_id"] for item in result["feature_results"]], [ "mirror_plane", "boss_add", "mirror", "move_copy", ]) def test_boolean_can_union_one_proven_mirror_pattern_copy(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "mirror-copy-boolean", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "boss", "workplane": _workplane(), "profile": {"type": "circle", "center": [10, 0], "radius_mm": 1}, }]}, "features": [ {"id": "mirror_plane", "atomic_id": "reference_plane", "depends_on": [], "params": { "plane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]}, }}, {"id": "boss_add", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "boss", "params": { "distance_mm": 2, "result_mode": "new_body", }}, {"id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["boss_add", "mirror_plane"], "params": { "source_feature_ids": ["boss_add"], "mirror_current_body": True, "mirror_plane": {"kind": "plane", "owner_feature_id": "mirror_plane"}, }, "selectors": [{"kind": "plane", "owner_feature_id": "mirror_plane"}]}, {"id": "join", "atomic_id": "boolean_bodies", "depends_on": ["mirror"], "params": { "operation": "union", "target_feature_ids": ["boss_add"], "tool_pattern_instance_refs": [{ "pattern_feature_id": "mirror", "source_feature_id": "boss_add", "instance_index": 1, }], "keep_tools": False, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "mirror-copy-boolean.step") self.assertEqual(result["solid_count"], 2) self.assertAlmostEqual(result["volume_mm3"], 4 * math.pi, places=5) self.assertEqual(result["bbox_mm"], {"min": [-11.0, -1.0, 0.0], "max": [11.0, 1.0, 2.0]}) self.assertEqual([item["feature_id"] for item in result["feature_results"]], [ "mirror_plane", "boss_add", "mirror", "join", ]) def test_boolean_pattern_instance_requires_a_surviving_member(self) -> None: cdsl = self._base_block() cdsl["features"][0]["params"]["result_mode"] = "new_body" cdsl["features"].extend([ { "id": "mirror_plane", "atomic_id": "reference_plane", "depends_on": [], "params": { "plane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]}, }, }, { "id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["base_add", "mirror_plane"], "params": { "source_feature_ids": ["base_add"], "mirror_plane": { "kind": "plane", "owner_feature_id": "mirror_plane", "stable_id": "mirror-plane", "source": "runtime_snapshot", "confidence": 1, }, }, "selectors": [{ "kind": "plane", "owner_feature_id": "mirror_plane", "stable_id": "mirror-plane", "source": "runtime_snapshot", "confidence": 1, }], }, { "id": "join", "atomic_id": "boolean_bodies", "depends_on": ["mirror"], "params": { "operation": "union", "target_feature_ids": ["base_add"], "tool_pattern_instance_refs": [{ "pattern_feature_id": "mirror", "source_feature_id": "base_add", "instance_index": 2, }], "keep_tools": False, }, }, ]) for feature in cdsl["features"]: feature["execution_status"] = "supported" from cdsl_engine.semantic_validation import validate_semantic_cdsl with self.assertRaisesRegex(ValueError, "not a surviving copy"): validate_semantic_cdsl(cdsl) analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "reference_plane", "pattern_mirror", "boolean_bodies"}, profile_types=SHAPE_GENERATORS, ).analyze(cdsl) blocker = next(item for item in analysis.feature_results[-1].blockers if item.code == "pattern_instance_unavailable") self.assertEqual(blocker.detail, { "pattern_feature_id": "mirror", "source_feature_id": "base_add", "instance_index": 2, }) def test_mirror_pattern_instance_reference_rejects_any_instance_but_one(self) -> None: from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() cdsl["features"][0]["params"]["result_mode"] = "new_body" cdsl["features"].extend([ { "id": "mirror_plane", "atomic_id": "reference_plane", "depends_on": [], "params": { "plane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]}, }, }, { "id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["base_add", "mirror_plane"], "params": { "source_feature_ids": ["base_add"], "mirror_plane": { "kind": "plane", "owner_feature_id": "mirror_plane", "stable_id": "mirror-plane", "source": "runtime_snapshot", "confidence": 1, }, }, "selectors": [{ "kind": "plane", "owner_feature_id": "mirror_plane", "stable_id": "mirror-plane", "source": "runtime_snapshot", "confidence": 1, }], }, { "id": "move", "atomic_id": "transform_bodies", "depends_on": ["mirror"], "params": { "pattern_instance_refs": [{"pattern_feature_id": "mirror", "source_feature_id": "base_add", "instance_index": 2}], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": False, }, }, ]) for feature in cdsl["features"]: feature["execution_status"] = "supported" with self.assertRaisesRegex(ValueError, "not a surviving copy"): validate_semantic_cdsl(cdsl) def test_mirror_pattern_instance_reference_requires_a_new_body_source(self) -> None: from cdsl_engine.semantic_validation import validate_semantic_cdsl cdsl = self._base_block() cdsl["features"].extend([ { "id": "mirror_plane", "atomic_id": "reference_plane", "depends_on": [], "params": { "plane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]}, }, }, { "id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["base_add", "mirror_plane"], "params": { "source_feature_ids": ["base_add"], "mirror_plane": { "kind": "plane", "owner_feature_id": "mirror_plane", "stable_id": "mirror-plane", "source": "runtime_snapshot", "confidence": 1, }, }, "selectors": [{ "kind": "plane", "owner_feature_id": "mirror_plane", "stable_id": "mirror-plane", "source": "runtime_snapshot", "confidence": 1, }], }, { "id": "move", "atomic_id": "transform_bodies", "depends_on": ["mirror"], "params": { "pattern_instance_refs": [{"pattern_feature_id": "mirror", "source_feature_id": "base_add", "instance_index": 1}], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": False, }, }, ]) for feature in cdsl["features"]: feature["execution_status"] = "supported" with self.assertRaisesRegex(ValueError, "requires a preceding new_body mirror source"): validate_semantic_cdsl(cdsl) def test_pattern_instance_reference_rejects_an_excluded_copy(self) -> None: cdsl = self._base_block() cdsl["features"][0]["params"]["result_mode"] = "new_body" cdsl["features"].extend([ { "id": "pattern", "atomic_id": "pattern_circular", "depends_on": ["base_add"], "params": { "source_feature_ids": ["base_add"], "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "pattern_count": 3, "sweep_angle_deg": 360, "excluded_instance_indices": [1], }, "execution_status": "supported", }, { "id": "move", "atomic_id": "transform_bodies", "depends_on": ["pattern"], "params": { "pattern_instance_refs": [{"pattern_feature_id": "pattern", "source_feature_id": "base_add", "instance_index": 1}], "transform": {"type": "translation", "translation_mm": [1, 0, 0]}, "make_copy": False, }, "execution_status": "supported", }, ]) cdsl["features"][0]["execution_status"] = "supported" from cdsl_engine.semantic_validation import validate_semantic_cdsl with self.assertRaisesRegex(ValueError, "not a surviving copy"): validate_semantic_cdsl(cdsl) def test_mirror_pattern_can_union_the_active_body(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "mirror-active-body", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "base", "workplane": _workplane(), "profile": _rectangle([-5, -5], [5, 5])}, {"id": "half_cut", "workplane": _workplane(), "profile": _rectangle([-5, 0], [5, 5])}, {"id": "hole", "workplane": _workplane(), "profile": {"type": "circle", "center": [0, -2], "radius_mm": 1}}, ]}, "features": [ {"id": "mirror_plane", "atomic_id": "reference_plane", "depends_on": [], "params": {"plane": {"origin_mm": [0, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 1, 0]}}, "execution_status": "supported"}, {"id": "base_add", "atomic_id": "extrude_add_blind", "depends_on": ["mirror_plane"], "params": {"distance_mm": 2}, "sketch_id": "base", "execution_status": "supported"}, {"id": "half_remove", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 2}, "sketch_id": "half_cut", "execution_status": "supported"}, {"id": "hole_remove", "atomic_id": "extrude_cut_blind", "depends_on": ["half_remove"], "params": {"distance_mm": 2}, "sketch_id": "hole", "execution_status": "supported"}, { "id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["hole_remove", "mirror_plane"], "params": {"source_feature_ids": ["base_add"], "mirror_current_body": True, "mirror_plane": {"kind": "plane", "owner_feature_id": "mirror_plane"}}, "selectors": [{"kind": "plane", "owner_feature_id": "mirror_plane"}], "execution_status": "supported", }, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "mirror-active-body.step") self.assertAlmostEqual(result["volume_mm3"], 200 - 4 * 3.141592653589793, places=5) self.assertEqual(result["solid_count"], 1) def test_mirrored_local_circle_preserves_its_reflected_world_position(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter from cdsl_engine.runtime import _mirrored_sketch from cdsl_engine.sketch_solver import resolve_all_sketches cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{ "id": "circles", "workplane": _workplane(), "profile": {"type": "circle", "center": [2, 3], "radius_mm": 1}, }]}, "features": [], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] mirror_plane = PlaneSpec.from_mapping({ "origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0], }) mirrored = _mirrored_sketch(sketch, mirror_plane) face = Build123dGeometryAdapter().faces_for_sketch(mirrored)[0] center = face.center() self.assertAlmostEqual(center.X, -2.0) self.assertAlmostEqual(center.Y, 3.0) self.assertAlmostEqual(center.Z, 0.0) def test_circle_profile_retains_one_topological_circle_edge(self) -> None: from cdsl_engine.build123d_adapter import Build123dGeometryAdapter cdsl = { "schema": "cad.cdsl.llm.v1", "geometry": {"sketches": [{ "id": "circle", "workplane": _workplane(), "profile": {"type": "circle", "center": [2, 3], "radius_mm": 1}, }]}, "features": [], } sketch = resolve_all_sketches(cdsl)["geometry"]["sketches"][0] self.assertNotIn("contour_edges_mm", sketch) face = Build123dGeometryAdapter().faces_for_sketch(sketch)[0] self.assertEqual(len(face.outer_wire().edges()), 1) def test_new_body_mode_preserves_an_overlapping_result_body(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "overlap", "workplane": _workplane(), "profile": _rectangle([-2, -5], [8, 5]), }) cdsl["features"].append({ "id": "second_body", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "params": {"distance_mm": 10, "result_mode": "new_body"}, "sketch_id": "overlap", }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "two-bodies.step") self.assertEqual(result["solid_count"], 2) def test_sweep_add_builds_a_solid_from_a_closed_profile_and_bspline_path(self) -> None: from cdsl_engine.runtime import rebuild_cdsl profile_plane = {"origin_mm": [0, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 1, 0]} cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "sweep-add", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": profile_plane, "profile": {"type": "circle", "radius_mm": 2}, }]}, "features": [{ "id": "sweep", "atomic_id": "sweep_add", "depends_on": [], "sketch_id": "profile", "params": {"path": { "workplane": _workplane(), "segment": { "type": "bspline", "start": [0, 0], "end": [0, 20], "points": [[0, 0], [0, 10], [0, 20]], "start_tangent": [0, 10], "end_tangent": [0, 10], }, }}, }], } with tempfile.TemporaryDirectory() as directory: root = Path(directory) result = rebuild_cdsl(cdsl, root / "sweep.step") shelled = deepcopy(cdsl) shelled["features"].append({ "id": "shell", "atomic_id": "shell", "depends_on": ["sweep"], "params": {"thickness_mm": 0.25, "inward": True}, "selectors": [{ "kind": "face", "owner_feature_id": "sweep", "output_role": "sweep.end", "source": "runtime_snapshot", "confidence": 1, }], }) downstream = rebuild_cdsl(shelled, root / "sweep-shell.step") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], 80 * math.pi, delta=1e-4) delta = next(item for item in result["topology_deltas"] if item["operation"] == "sweep") self.assertEqual( {item.get("output_role") for item in delta["relations"] if item.get("output_role") is not None}, {"sweep.start", "sweep.end"}, ) self.assertTrue(any( item.get("source_kind") == "edge" and item.get("result_kind") == "face" and item.get("derivation") == "boundary" and item.get("coverage") == "complete" and item.get("status") == "recorded_without_owner_transfer" for item in delta["relations"] )) self.assertTrue(all( item["event"] == "generated" and item["status"] == "recorded_without_owner_transfer" and item["result_record_ids"] for item in delta["relations"] )) self.assertTrue(any( item["feature_id"] == "sweep" and item.get("output_roles") == ["sweep.end"] for item in result["topology_records"] )) self.assertEqual(downstream["runtime_diagnostics"], []) self.assertTrue(any( item["feature_id"] == "shell" and item["status"] == "resolved" and item["selected"].get("output_roles") == ["sweep.end"] for item in downstream["selector_resolution"] )) def test_sweep_add_builds_a_solid_from_a_directed_arc_path(self) -> None: from cdsl_engine.runtime import analyze_cdsl, rebuild_cdsl profile_plane = {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]} cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "arc-sweep", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": profile_plane, "profile": {"type": "circle", "radius_mm": 2}, }]}, "features": [{ "id": "sweep", "atomic_id": "sweep_add", "depends_on": [], "sketch_id": "profile", "params": {"path": {"workplane": _workplane(), "segment": { "type": "arc", "start": [0, 0], "end": [10, 10], "center": [0, 10], "radius_mm": 10, "clockwise": True, }}}, }], } self.assertTrue(analyze_cdsl(cdsl).runtime_eligible) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "arc-sweep.step") self.assertEqual(result["solid_count"], 1) self.assertGreater(result["volume_mm3"], 0) invalid = deepcopy(cdsl) invalid["features"][0]["params"]["path"]["segment"].pop("clockwise") blocker = analyze_cdsl(invalid).feature_results[0].blockers[0] self.assertEqual(blocker.code, "invalid_sweep_path") def test_sweep_cut_uses_a_transient_tool_and_preserves_target_cut_history(self) -> None: from cdsl_engine.runtime import analyze_cdsl, rebuild_cdsl profile_plane = {"origin_mm": [0, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 1, 0]} cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "sweep-cut", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "base", "workplane": _workplane(), "profile": _rectangle([-5, -5], [5, 5])}, {"id": "tool", "workplane": profile_plane, "profile": {"type": "circle", "radius_mm": 1}}, ]}, "features": [ {"id": "base", "atomic_id": "extrude_add_blind", "depends_on": [], "sketch_id": "base", "params": {"distance_mm": 10}}, {"id": "cut", "atomic_id": "sweep_cut", "depends_on": ["base"], "sketch_id": "tool", "params": {"path": {"workplane": _workplane(), "segment": {"type": "line", "start": [0, 0], "end": [0, 20]}}}}, ], } self.assertTrue(analyze_cdsl(cdsl).runtime_eligible) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "sweep-cut.step") self.assertEqual(result["solid_count"], 1) self.assertLess(result["volume_mm3"], 1000) delta = next(item for item in result["topology_deltas"] if item["feature_id"] == "cut") self.assertEqual(delta["operation"], "subtract") self.assertTrue(delta["relations"]) self.assertFalse(any(item["record_id"].startswith("transient:cut") for item in result["topology_records"])) def test_sweep_add_builds_a_solid_from_two_point_bspline_with_endpoint_tangents(self) -> None: from cdsl_engine.runtime import analyze_cdsl, rebuild_cdsl profile_plane = {"origin_mm": [0, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 1, 0]} cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "two-point-sweep", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": profile_plane, "profile": {"type": "circle", "radius_mm": 2}, }]}, "features": [{ "id": "sweep", "atomic_id": "sweep_add", "depends_on": [], "sketch_id": "profile", "params": {"path": { "workplane": _workplane(), "segment": { "type": "bspline", "start": [0, 0], "end": [6, 10], "points": [[0, 0], [6, 10]], "parameters": [0, 1], "start_tangent": [0, 10], "end_tangent": [10, 0], }, }}, }], } self.assertTrue(analyze_cdsl(cdsl).runtime_eligible) missing_tangent = deepcopy(cdsl) missing_tangent["features"][0]["params"]["path"]["segment"].pop("end_tangent") blocker = analyze_cdsl(missing_tangent).feature_results[0].blockers[0] self.assertEqual(blocker.code, "invalid_sweep_path") self.assertEqual(blocker.message, "A two-point B-spline sweep path requires both endpoint tangents") with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "two-point-sweep.step") self.assertEqual(result["solid_count"], 1) self.assertGreater(result["volume_mm3"], 0) def test_sweep_add_builds_a_solid_from_spatial_segmented_path(self) -> None: from cdsl_engine.runtime import analyze_cdsl, rebuild_cdsl profile_plane = {"origin_mm": [0, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 0, 1]} cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "spatial-sweep", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": profile_plane, "profile": {"type": "circle", "radius_mm": 2}, }]}, "features": [{ "id": "sweep", "atomic_id": "sweep_add", "depends_on": [], "sketch_id": "profile", "params": {"path": {"segments": [ { "type": "line", "start_mm": [0, 0, 0], "end_mm": [0, 0, 10], "source_sketch_id": "F1", "source_entity_id": "E0", }, { "type": "line", "start_mm": [0, 0, 10], "end_mm": [10, 0, 10], "source_sketch_id": "F2", "source_entity_id": "E1", }, ]}}, }], } self.assertTrue(analyze_cdsl(cdsl).runtime_eligible) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "spatial-sweep.step") self.assertEqual(result["solid_count"], 1) self.assertGreater(result["volume_mm3"], 0) duplicate_source = deepcopy(cdsl) duplicate_source["features"][0]["params"]["path"]["segments"][1]["source_sketch_id"] = "F1" duplicate_source["features"][0]["params"]["path"]["segments"][1]["source_entity_id"] = "E0" blocker = analyze_cdsl(duplicate_source).feature_results[0].blockers[0] self.assertEqual(blocker.code, "invalid_sweep_path") self.assertEqual(blocker.message, "Sweep spatial path must not repeat one source sketch entity") def test_sweep_history_falls_back_for_hollow_profiles(self) -> None: from build123d import Edge, Face, Plane, Vector, Wire from cdsl_engine.build123d_adapter import Build123dGeometryAdapter adapter = Build123dGeometryAdapter() outer = Face(Wire.make_circle(4, Plane.XZ)) inner = Face(Wire.make_circle(2, Plane.XZ)) profile = adapter.face_with_holes(outer, [inner]) result, delta = adapter.sweep_with_topology_delta( profile, Edge.make_line(Vector(0, 0, 0), Vector(0, 10, 0)), ) self.assertIsNone(delta) self.assertAlmostEqual(float(result.volume), 120 * math.pi, places=5) def test_sweep_native_fallback_translates_empty_kernel_assertion(self) -> None: from build123d import Face, Plane, Wire from cdsl_engine.build123d_adapter import Build123dGeometryAdapter adapter = Build123dGeometryAdapter() outer = Face(Wire.make_circle(28.03, Plane.XY)) inner = Face(Wire.make_circle(24.77, Plane.XY)) profile = adapter.face_with_holes(outer, [inner]) path = adapter.sweep_path_segments([ {"type": "line", "start_mm": [0, 0, 0], "end_mm": [0, 0, 55.85]}, {"type": "line", "start_mm": [0, 0, 55.85], "end_mm": [63.5, 0, 55.85]}, ]) with self.assertRaisesRegex(ValueError, "OCC sweep operation raised while building the native sweep"): adapter.sweep_with_topology_delta(profile, path) def test_sweep_history_matches_native_builder_for_a_curved_path(self) -> None: from build123d import Edge, Face, Plane, Vector, Wire from cdsl_engine.build123d_adapter import Build123dGeometryAdapter adapter = Build123dGeometryAdapter() profile = Face(Wire.make_circle(2, Plane.XZ)) path = Edge.make_spline([ Vector(0, 0, 0), Vector(0, 10, 0), Vector(5, 20, 0), ], scale=False) direct, delta = adapter.sweep_with_topology_delta(profile, path) native = adapter._sweep_without_topology_delta(profile, path) self.assertIsNotNone(delta) self.assertTrue(direct.is_valid) self.assertAlmostEqual(float(direct.volume), float(native.volume), places=5) self.assertEqual(len(direct.faces()), len(native.faces())) self.assertEqual( [relation.output_role for relation in delta.relations if relation.kind == "face"], ["sweep.start", "sweep.end"], ) side_relations = [ relation for relation in delta.relations if relation.source_kind == "edge" and relation.result_kind == "face" ] self.assertEqual(len(side_relations), 1) self.assertEqual(side_relations[0].coverage, "complete") self.assertEqual(side_relations[0].status, "proven") def test_sweep_history_captures_each_direct_profile_vertex_edge(self) -> None: from build123d import Edge, Face, Plane, Vector from cdsl_engine.build123d_adapter import Build123dGeometryAdapter adapter = Build123dGeometryAdapter() profile = Face.make_rect(8, 6, Plane.XZ) _solid, delta = adapter.sweep_with_topology_delta( profile, Edge.make_line(Vector(0, 0, 0), Vector(0, 20, 0)), ) self.assertIsNotNone(delta) swept_vertex_relations = [ relation for relation in delta.relations if relation.source_kind == "vertex" and relation.result_kind == "edge" ] self.assertEqual(len(swept_vertex_relations), 4) self.assertTrue(all(relation.result_values for relation in swept_vertex_relations)) self.assertTrue(all(relation.coverage == "complete" for relation in swept_vertex_relations)) self.assertTrue(all(relation.status == "proven" for relation in swept_vertex_relations)) def test_initial_loft_captures_builder_proven_cap_evidence(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "loft-history", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "lower", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 2}}, { "id": "upper", "workplane": {"origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "normal": [0, 0, 1]}, "profile": {"type": "circle", "radius_mm": 4}, }, { "id": "extension", "workplane": {"origin_mm": [0, 0, 20], "x_dir": [1, 0, 0], "normal": [0, 0, 1]}, "profile": {"type": "circle", "radius_mm": 3}, }, ]}, "features": [{ "id": "loft", "atomic_id": "loft_add", "depends_on": [], "params": {"profile_sketch_ids": ["lower", "upper"]}, }], } with tempfile.TemporaryDirectory() as directory: root = Path(directory) result = rebuild_cdsl(cdsl, root / "loft.step") extended = deepcopy(cdsl) extended["features"].append({ "id": "loft_extension", "atomic_id": "loft_add_with_cap_face", "depends_on": ["loft"], "params": {"profile_sketch_ids": ["extension"]}, "selectors": [{ "kind": "face", "owner_feature_id": "loft", "output_role": "loft.end", "source": "runtime_snapshot", "confidence": 1, }], }) downstream = rebuild_cdsl(extended, root / "loft-extension.step") self.assertAlmostEqual(result["volume_mm3"], 280 * math.pi / 3, places=5) delta = next(item for item in result["topology_deltas"] if item["operation"] == "loft") self.assertEqual( {item.get("output_role") for item in delta["relations"]}, {"loft.start", "loft.end"}, ) self.assertTrue(all( item["event"] == "generated" and item["status"] == "recorded_without_owner_transfer" and item["result_record_ids"] for item in delta["relations"] )) self.assertTrue(any( item["feature_id"] == "loft" and item.get("output_roles") == ["loft.end"] for item in result["topology_records"] )) self.assertEqual(downstream["runtime_diagnostics"], []) self.assertTrue(any( item["feature_id"] == "loft_extension" and item["status"] == "resolved" and item["selected"].get("output_roles") == ["loft.end"] for item in downstream["selector_resolution"] )) def test_circular_pattern_rotates_a_sweep_profile_and_path(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "sweep-pattern", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": {"origin_mm": [10, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 0, -1]}, "profile": {"type": "circle", "radius_mm": 1}, }]}, "features": [ {"id": "sweep", "atomic_id": "sweep_add", "depends_on": [], "sketch_id": "profile", "params": {"path": { "workplane": {"origin_mm": [0, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 1, 0]}, "segment": {"type": "line", "start": [10, 0], "end": [10, 10]}, }}}, {"id": "pattern", "atomic_id": "pattern_circular", "depends_on": ["sweep"], "params": { "source_feature_ids": ["sweep"], "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "pattern_count": 3, "sweep_angle_deg": 360, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "sweep-pattern.step") self.assertEqual(result["solid_count"], 3) self.assertAlmostEqual(result["volume_mm3"], 30 * math.pi, delta=1e-4) def test_sweep_accepts_a_closed_circle_path_as_a_wire(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "closed-circle-sweep", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": {"origin_mm": [20, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 1, 0]}, "profile": {"type": "circle", "radius_mm": 2}, }]}, "features": [{ "id": "sweep", "atomic_id": "sweep_add", "depends_on": [], "sketch_id": "profile", "params": {"path": { "workplane": _workplane(), "segment": {"type": "circle", "center": [0, 0], "radius_mm": 20}, }}, }], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "closed-circle-sweep.step") self.assertEqual(result["solid_count"], 1) self.assertEqual(result["runtime_diagnostics"], []) self.assertAlmostEqual(result["volume_mm3"], 160 * math.pi**2, delta=1e-4) def test_circular_pattern_rotates_a_spatial_sweep_path(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "spatial-sweep-pattern", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": {"origin_mm": [10, 0, 0], "x_dir": [1, 0, 0], "normal": [0, 0, 1]}, "profile": {"type": "circle", "radius_mm": 1}, }]}, "features": [ {"id": "sweep", "atomic_id": "sweep_add", "depends_on": [], "sketch_id": "profile", "params": {"path": {"segments": [ { "type": "line", "start_mm": [10, 0, 0], "end_mm": [10, 0, 10], "source_sketch_id": "F1", "source_entity_id": "E0", }, { "type": "line", "start_mm": [10, 0, 10], "end_mm": [20, 0, 10], "source_sketch_id": "F2", "source_entity_id": "E1", }, ]}}}, {"id": "pattern", "atomic_id": "pattern_circular", "depends_on": ["sweep"], "params": { "source_feature_ids": ["sweep"], "axis": {"origin_mm": [0, 0, 0], "direction": [0, 0, 1]}, "pattern_count": 3, "sweep_angle_deg": 360, }}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "spatial-sweep-pattern.step") self.assertEqual(result["solid_count"], 3) self.assertGreater(result["volume_mm3"], 0) def test_shell_removes_a_selected_cap_and_offsets_inward(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") top = next( item for item in baseline["topology_records"] if item["kind"] == "face" and item["feature_id"] == "base_add" and item["geometry"].get("surface_type") == "plane" and item["geometry"].get("normal", [0, 0, 0])[2] > 0.9 ) shelled = deepcopy(base) shelled["features"].append({ "id": "shell", "atomic_id": "shell", "depends_on": ["base_add"], "params": {"thickness_mm": 1, "inward": True}, "selectors": [{ "kind": "face", "stable_id": top["record_id"], "snapshot_id": top["record_id"], "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": top["geometry"], }], }) result = rebuild_cdsl(shelled, root / "shell.step") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], 424.0, places=5) def test_shell_removes_a_selected_cap_and_offsets_outward(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") top = next( item for item in baseline["topology_records"] if item["kind"] == "face" and item["feature_id"] == "base_add" and item["geometry"].get("surface_type") == "plane" and item["geometry"].get("normal", [0, 0, 0])[2] > 0.9 ) shelled = deepcopy(base) shelled["features"].append({ "id": "shell", "atomic_id": "shell", "depends_on": ["base_add"], "params": {"thickness_mm": 1, "inward": False}, "selectors": [{ "kind": "face", "stable_id": top["record_id"], "snapshot_id": top["record_id"], "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": top["geometry"], }], }) result = rebuild_cdsl(shelled, root / "shell-outward.step") self.assertEqual(result["solid_count"], 1) # A shell is hollow on either side of the source skin. This confirms # the exterior offset reached a distinct OCC result rather than # silently using the inward default (424 mm^3 for this fixture). self.assertGreater(result["volume_mm3"], 424.0) def test_shell_explicit_target_requires_the_live_face_member(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") top = next( item for item in baseline["topology_records"] if item["kind"] == "face" and item["feature_id"] == "base_add" and item["geometry"].get("surface_type") == "plane" and item["geometry"].get("normal", [0, 0, 0])[2] > 0.9 ) shelled = deepcopy(base) shelled["features"].append({ "id": "shell", "atomic_id": "shell", "depends_on": ["base_add"], "params": {"thickness_mm": 1, "inward": True, "target_feature_id": "base_add"}, "selectors": [{ "kind": "face", "stable_id": top["record_id"], "snapshot_id": top["record_id"], "source": "runtime_snapshot", "confidence": 1, "owner_feature_id": "base_add", "geometry": top["geometry"], }], }) result = rebuild_cdsl(shelled, root / "shell.step") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], 424.0, places=5) invalid = deepcopy(shelled) invalid["features"][-1]["params"]["target_feature_id"] = "missing_body" analysis = CapabilityAnalyzer( atomic_ids={"extrude_add_blind", "shell"}, profile_types=SHAPE_GENERATORS, ).analyze(invalid) self.assertIn( "shell_target_body_unavailable", [blocker.code for blocker in analysis.feature_results[-1].blockers], ) def test_fillet_and_hole_wizard_use_resolved_face_edge_selectors(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") edge = next(item for item in baseline["topology_records"] if item["kind"] == "edge") top_face = next( item for item in baseline["topology_records"] if item["kind"] == "face" and item["geometry"]["surface_type"] == "plane" and item["geometry"]["normal"][2] > 0.9 ) with_fillet = deepcopy(base) with_fillet["features"].append({ "id": "fillet", "atomic_id": "fillet", "depends_on": ["base_add"], "params": {"radius_mm": 1}, "selectors": [{"kind": "edge", "stable_id": "edge", "source": "solidworks", "confidence": 1, "owner_feature_id": "base_add", "geometry": edge["geometry"]}], }) filleted = rebuild_cdsl(with_fillet, root / "fillet.step") with_hole = deepcopy(base) with_hole["features"].append({ "id": "hole", "atomic_id": "hole_wizard", "depends_on": ["base_add"], "params": { "hole_type": "plain", "diameter_mm": 2, "depth_mm": 5, "end_condition": {"type": "blind", "solidworks_code": 0}, "positions": [{"mm": [0, 0, 10]}], "host_face": {"kind": "face", "stable_id": "top", "source": "inferred_from_step", "confidence": 1, "geometry": top_face["geometry"]}, }, "selectors": [{"kind": "face", "stable_id": "top", "source": "inferred_from_step", "confidence": 1, "geometry": top_face["geometry"]}], }) holed = rebuild_cdsl(with_hole, root / "hole.step") self.assertLess(filleted["volume_mm3"], baseline["volume_mm3"]) self.assertAlmostEqual(holed["volume_mm3"], 1000 - 5 * 3.141592653589793, places=5) def test_hole_frame_uses_local_coordinates(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() base["features"].append({ "id": "hole", "atomic_id": "hole_blind", "depends_on": ["base_add"], "sketch_id": "base", "params": { "diameter_mm": 2, "depth_mm": 5, "positions": [{"mm": [0, 0, 0]}], "host_face": {"frame": {"origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "y_dir": [0, 1, 0], "normal": [0, 0, 1]}}, }, }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(base, Path(directory) / "local-hole.step") self.assertAlmostEqual(result["volume_mm3"], 1000 - 5 * 3.141592653589793, places=5) def test_scoped_holes_preserve_the_original_body_member(self) -> None: from cdsl_engine.runtime import prepare_cdsl_execution cdsl = self._base_block() host_frame = { "origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "y_dir": [0, 1, 0], "normal": [0, 0, 1], } for feature_id, position in (("first_hole", [-2, 0, 0]), ("second_hole", [2, 0, 0])): cdsl["features"].append({ "id": feature_id, "atomic_id": "hole_wizard", "depends_on": ["base_add" if feature_id == "first_hole" else "first_hole"], "params": { "hole_type": "plain", "diameter_mm": 2, "depth_mm": 5, "end_condition": {"type": "blind", "solidworks_code": 0}, "positions": [{"mm": position}], "host_face": {"frame": host_frame}, "scope_feature_id": "base_add", }, }) execution = prepare_cdsl_execution(cdsl) self.assertTrue(all(result.executable for result in execution.analysis.feature_results)) execution.execute_all() self.assertEqual(set(execution.session.body_members), {"base_add"}) self.assertLess(float(execution.session.body.volume), 1000.0) def test_unscoped_hole_keeps_the_legacy_feature_owned_member(self) -> None: from cdsl_engine.runtime import prepare_cdsl_execution cdsl = self._base_block() cdsl["features"].append({ "id": "hole", "atomic_id": "hole_wizard", "depends_on": ["base_add"], "params": { "hole_type": "plain", "diameter_mm": 2, "depth_mm": 5, "end_condition": {"type": "blind", "solidworks_code": 0}, "positions": [{"mm": [0, 0, 0]}], "host_face": {"frame": {"origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "y_dir": [0, 1, 0], "normal": [0, 0, 1]}}, }, }) execution = prepare_cdsl_execution(cdsl) self.assertTrue(all(result.executable for result in execution.analysis.feature_results)) execution.execute_all() self.assertEqual(set(execution.session.body_members), {"hole"}) def test_scoped_hole_cuts_only_its_explicit_live_member(self) -> None: from cdsl_engine.runtime import prepare_cdsl_execution cdsl = _two_body_boolean_cdsl( "union", _rectangle([-5, -5], [5, 5]), _rectangle([20, -5], [30, 5]), ) cdsl["features"] = cdsl["features"][:2] cdsl["features"].append({ "id": "scoped_hole", "atomic_id": "hole_wizard", "depends_on": ["left_body", "right_body"], "params": { "hole_type": "plain", "diameter_mm": 2, "depth_mm": 2, "end_condition": {"type": "blind", "solidworks_code": 0}, "positions": [{"mm": [0, 0, 0]}], "host_face": {"frame": {"origin_mm": [0, 0, 4], "x_dir": [1, 0, 0], "y_dir": [0, 1, 0], "normal": [0, 0, 1]}}, "scope_feature_id": "left_body", }, }) execution = prepare_cdsl_execution(cdsl) self.assertTrue(execution.analysis.feature_results[-1].executable) execution.execute_all() self.assertEqual(set(execution.session.body_members), {"left_body", "right_body"}) self.assertAlmostEqual(float(execution.session.body.volume), 800.0 - 2.0 * math.pi, places=5) self.assertAlmostEqual(float(execution.session.body_members["right_body"].volume), 400.0, places=5) def test_counterbore_and_countersink_holes_execute_with_explicit_host_frames(self) -> None: """Keep both legacy hole contracts covered by an actual kernel rebuild.""" from cdsl_engine.runtime import rebuild_cdsl host_frame = { "origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "y_dir": [0, 1, 0], "normal": [0, 0, 1], } for atomic_id, details in ( ("hole_counterbore", {"counterbore_diameter_mm": 4, "counterbore_depth_mm": 2}), ("hole_countersink", {"countersink_diameter_mm": 4, "countersink_angle_rad": 1.5707963267948966}), ): with self.subTest(atomic_id=atomic_id): cdsl = self._base_block() cdsl["features"].append({ "id": atomic_id, "atomic_id": atomic_id, "depends_on": ["base_add"], "params": { "diameter_mm": 2, "depth_mm": 5, "positions": [{"mm": [0, 0, 0]}], "host_face": {"frame": host_frame}, **details, }, }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / f"{atomic_id}.step") self.assertLess(result["volume_mm3"], 1000.0) self.assertIn(atomic_id, [item["feature_id"] for item in result["feature_results"]]) def test_sphere_add_executes_without_a_sketch(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "sphere", "meta": {"unit": "mm"}, "geometry": {"sketches": []}, "features": [{ "id": "sphere", "atomic_id": "sphere_add", "depends_on": [], "params": {"radius_mm": 2, "center_mm": [0, 0, 0]}, }], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "sphere.step") self.assertAlmostEqual(result["volume_mm3"], 32 * 3.141592653589793 / 3, places=5) self.assertEqual(result["feature_results"][-1]["feature_id"], "sphere") def test_pattern_with_selector_source_is_blocked_before_execution(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["features"].extend([ {"id": "fillet", "atomic_id": "fillet", "depends_on": ["base_add"], "params": {"radius_mm": 1}, "selectors": [{"kind": "edge", "stable_id": "edge", "source": "solidworks", "confidence": 1}]}, {"id": "repeat", "atomic_id": "pattern_linear", "depends_on": ["fillet"], "params": {"source_feature_ids": ["fillet"], "direction_1": [1, 0, 0], "spacing_1_mm": 10, "pattern_count_1": 2}}, ]) analysis = analyze_cdsl(cdsl) pattern = next(item for item in analysis.feature_results if item.feature_id == "repeat") self.assertFalse(pattern.executable) self.assertIn("unsupported_pattern_selector_transform", [item.code for item in pattern.blockers]) def test_chamfer_and_linear_pattern_execute_without_selector_guessing(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() base["geometry"]["sketches"].append({ "id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [-2, 0], "radius_mm": 1}, }) with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") edge = next(item for item in baseline["topology_records"] if item["kind"] == "edge") chamfered = deepcopy(base) chamfered["features"].append({ "id": "chamfer", "atomic_id": "chamfer", "depends_on": ["base_add"], "params": {"distance_mm": 1}, "selectors": [{"kind": "edge", "stable_id": "edge", "source": "solidworks", "confidence": 1, "owner_feature_id": "base_add", "geometry": edge["geometry"]}], }) chamfer_result = rebuild_cdsl(chamfered, root / "chamfer.step") patterned = deepcopy(base) patterned["features"].extend([ {"id": "cut_1", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 10}, "sketch_id": "cut"}, {"id": "repeat", "atomic_id": "pattern_linear", "depends_on": ["cut_1"], "params": {"source_feature_ids": ["cut_1"], "direction_1": [1, 0, 0], "spacing_1_mm": 2, "pattern_count_1": 3}}, ]) pattern_result = rebuild_cdsl(patterned, root / "pattern.step") self.assertLess(chamfer_result["volume_mm3"], baseline["volume_mm3"]) self.assertAlmostEqual(pattern_result["volume_mm3"], 1000 - 3 * 10 * 3.141592653589793, places=5) def test_chamfer_consumes_angle_rad_instead_of_silent_45_degree_fallback(self) -> None: from cdsl_engine.runtime import rebuild_cdsl import math base = self._base_block() with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") edge = next(item for item in baseline["topology_records"] if item["kind"] == "edge") selector = { "kind": "edge", "stable_id": "edge", "source": "solidworks", "confidence": 1, "owner_feature_id": "base_add", "geometry": edge["geometry"], } equal = deepcopy(base) equal["features"].append({ "id": "chamfer_45", "atomic_id": "chamfer", "depends_on": ["base_add"], "params": {"distance_mm": 1, "angle_rad": math.pi / 4}, "selectors": [deepcopy(selector)], }) equal_result = rebuild_cdsl(equal, root / "chamfer-45.step") # 45° Distance-Angle 等价于等距倒角：tan(45°)=1，切掉 0.5*1*1*10=5 mm³。 self.assertAlmostEqual(equal_result["volume_mm3"], 1000 - 5, places=5) slanted = deepcopy(base) slanted["features"].append({ "id": "chamfer_30", "atomic_id": "chamfer", "depends_on": ["base_add"], "params": {"distance_mm": 1, "angle_rad": math.pi / 6}, "selectors": [deepcopy(selector)], }) slanted_result = rebuild_cdsl(slanted, root / "chamfer-30.step") # 30°：第二距离 = 1*tan(30°)≈0.577，切掉 0.5*1*0.577*10≈2.887 mm³， # 体积明显大于 45° 等距倒角（995），验证 angle_rad 被消费而非静默 45°。 self.assertAlmostEqual(slanted_result["volume_mm3"], 1000 - 0.5 * math.tan(math.pi / 6) * 10, places=5) def test_linear_pattern_replays_hole_with_explicit_host_frame(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["features"].extend([ { "id": "hole_1", "atomic_id": "hole_blind", "depends_on": ["base_add"], "sketch_id": "base", "params": { "diameter_mm": 2, "depth_mm": 5, "positions": [{"mm": [0, 0, 0]}], "host_face": {"frame": { "origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "y_dir": [0, 1, 0], "normal": [0, 0, 1], }}, }, }, { "id": "repeat", "atomic_id": "pattern_linear", "depends_on": ["hole_1"], "params": { "source_feature_ids": ["hole_1"], "direction_1": [1, 0, 0], "spacing_1_mm": 4, "pattern_count_1": 2, }, }, ]) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "patterned-holes.step") self.assertAlmostEqual(result["volume_mm3"], 1000 - 2 * 5 * 3.141592653589793, places=5) def test_mirror_pattern_replays_local_hole_coordinates_in_the_correct_quadrant(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["features"].insert(0, { "id": "mirror_plane", "atomic_id": "reference_plane", "depends_on": [], "params": {"plane": {"origin_mm": [0, 0, 0], "x_dir": [0, 1, 0], "normal": [1, 0, 0]}}, }) cdsl["features"].extend([ { "id": "hole_1", "atomic_id": "hole_blind", "depends_on": ["base_add"], "sketch_id": "base", "params": { "diameter_mm": 2, "depth_mm": 5, "positions": [{"mm": [2, 3, 0]}], "host_face": {"frame": { "origin_mm": [0, 0, 10], "x_dir": [1, 0, 0], "y_dir": [0, 1, 0], "normal": [0, 0, 1], }}, }, }, { "id": "mirror", "atomic_id": "pattern_mirror", "depends_on": ["hole_1", "mirror_plane"], "params": { "source_feature_ids": ["hole_1"], "mirror_plane": {"kind": "plane", "owner_feature_id": "mirror_plane"}, }, "selectors": [{"kind": "plane", "owner_feature_id": "mirror_plane"}], }, ]) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "mirrored-holes.step") mirrored_cylinder = next( item for item in result["topology_records"] if item["record_id"].startswith("body:mirror.m.hole_1:face") and item["geometry"].get("surface_type") == "cylinder" and item["geometry"]["bbox_mm"][0] < -2.9 ) self.assertEqual(mirrored_cylinder["geometry"]["bbox_mm"][:2], [-3.0, 2.0]) self.assertEqual(mirrored_cylinder["geometry"]["bbox_mm"][3:5], [-1.0, 4.0]) def test_pattern_replays_selected_sources_in_history_order(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }) cdsl["features"].extend([ { "id": "cut_1", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 10}, "sketch_id": "cut", }, { "id": "repeat", "atomic_id": "pattern_linear", "depends_on": ["cut_1"], # SolidWorks selection exports are not guaranteed to match # history order; the executor must replay the boss before its cut. "params": { "source_feature_ids": ["cut_1", "base_add"], "direction_1": [1, 0, 0], "spacing_1_mm": 20, "pattern_count_1": 2, }, }, ]) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "ordered-pattern.step") self.assertAlmostEqual(result["volume_mm3"], 2 * (1000 - 10 * 3.141592653589793), places=5) def test_through_all_extent_uses_current_body(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }) cdsl["features"].append({ "id": "cut_all", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 0, "end_condition": {"type": "through_all", "solidworks_code": 1}}, "sketch_id": "cut", }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "through.step") self.assertAlmostEqual(result["volume_mm3"], 1000 - 10 * 3.141592653589793, places=5) def test_two_sided_extrude_uses_independent_forward_and_reverse_distances(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() feature = cdsl["features"][0] feature["atomic_id"] = "extrude_add_two_sided" feature["params"] = { "distance_mm": 2, "reverse_distance_mm": 3, "end_condition": {"type": "blind"}, "reverse_end_condition": {"type": "blind"}, } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "two-sided.step") self.assertAlmostEqual(result["volume_mm3"], 500.0) self.assertEqual(result["bbox_mm"]["min"][2], -3.0) self.assertEqual(result["bbox_mm"]["max"][2], 2.0) def test_two_sided_prism_fuse_does_not_preserve_half_prism_swept_edge_handles(self) -> None: """A symmetric prism needs a dedicated final relation for SWEPT_EDGE. Each half prism has exact ``Generated(vertex)`` evidence, but the fuse replaces those handles with the complete final edge. A resolver must not treat geometric continuity as a provenance continuation. """ from build123d import Face, Vector, Wire from cdsl_engine.build123d_adapter import Build123dGeometryAdapter face = Face(Wire.make_polygon([ Vector(-5, -5, 0), Vector(5, -5, 0), Vector(5, 5, 0), Vector(-5, 5, 0), Vector(-5, -5, 0), ])) forward, forward_delta = Build123dGeometryAdapter.extrude_with_topology_delta(face, (0, 0, 2)) reverse, reverse_delta = Build123dGeometryAdapter.extrude_with_topology_delta(face, (0, 0, -3)) fused = Build123dGeometryAdapter.fuse(forward, reverse) final_edges = [edge.wrapped for edge in fused.edges()] for delta in (forward_delta, reverse_delta): generated = [ value for relation in delta.relations if relation.source_kind == "vertex" and relation.result_kind == "edge" for value in relation.result_values ] self.assertTrue(generated) self.assertFalse(any( generated_edge.IsSame(final_edge) for generated_edge in generated for final_edge in final_edges )) def test_two_sided_extrude_requires_reverse_distance_contract(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() feature = cdsl["features"][0] feature["atomic_id"] = "extrude_add_two_sided" analysis = analyze_cdsl(cdsl) self.assertIn("missing_parameter", [item.code for item in analysis.feature_results[0].blockers]) def test_two_sided_cut_uses_independent_forward_and_reverse_distances(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "cut", "workplane": {**_workplane(), "origin_mm": [0, 0, 5]}, "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }) cdsl["features"].append({ "id": "cut_1", "atomic_id": "extrude_cut_two_sided", "depends_on": ["base_add"], "params": { "distance_mm": 3, "reverse_distance_mm": 5, "end_condition": {"type": "blind"}, "reverse_end_condition": {"type": "blind"}, }, "sketch_id": "cut", }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "two-sided-cut.step") self.assertAlmostEqual(result["volume_mm3"], 1000.0 - 8.0 * 3.141592653589793, places=5) def test_revolve_can_resolve_an_owner_qualified_reference_axis(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "axis-revolve", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "profile", "workplane": _workplane(), "profile": _rectangle([2, 1], [4, 2]), }]}, "features": [ { "id": "axis", "atomic_id": "reference_axis", "depends_on": [], "params": {"axis": {"origin_mm": [0, 0, 0], "direction": [1, 0, 0]}}, }, { "id": "revolve", "atomic_id": "revolve_add", "depends_on": ["axis"], "sketch_id": "profile", "params": { "angle_deg": 360, "axis": {"selector": {"kind": "axis", "owner_feature_id": "axis"}}, }, "selectors": [{"kind": "axis", "owner_feature_id": "axis"}], }, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "axis-revolve.step") self.assertAlmostEqual(result["volume_mm3"], 6 * 3.141592653589793, places=5) def test_revolve_cut_executes_against_an_existing_body(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "revolve_cut_profile", "workplane": _workplane(), "profile": _rectangle([-4, 1], [4, 2]), }) cdsl["features"].append({ "id": "revolve_cut", "atomic_id": "revolve_cut", "depends_on": ["base_add"], "sketch_id": "revolve_cut_profile", "params": {"angle_deg": 360, "axis": {"origin_mm": [0, 0, 0], "direction": [1, 0, 0]}}, }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "revolve-cut.step") self.assertLess(result["volume_mm3"], 1000.0) self.assertIn("revolve_cut", [item["feature_id"] for item in result["feature_results"]]) def test_revolve_surface_preserves_the_active_solid_and_registers_a_shell(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "surface_profile", "workplane": _workplane(), "profile": _rectangle([2, 1], [4, 2]), }) cdsl["features"].append({ "id": "surface_revolve", "atomic_id": "revolve_surface", "depends_on": ["base_add"], "sketch_id": "surface_profile", "params": {"angle_deg": 360, "axis": {"origin_mm": [0, 0, 0], "direction": [1, 0, 0]}}, }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "surface-revolve.step") surface = next(item for item in result["feature_results"] if item["feature_id"] == "surface_revolve") self.assertNotIn("body_id", surface) self.assertEqual(surface["surface_id"], "surface:surface_revolve") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], 1000.0) faces = [ item for item in result["topology_records"] if item["feature_id"] == "surface_revolve" and item["kind"] == "face" ] self.assertEqual(len(faces), 4) def test_extrude_surface_preserves_the_active_solid_and_registers_a_shell(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = self._base_block() cdsl["geometry"]["sketches"].append({ "id": "surface_profile", "workplane": _workplane(), "profile": { "type": "analytic_contours", "contours": [{ "role": "unknown", "closed": True, "segments": [{"type": "circle", "center": [5, 5], "radius_mm": 2}], }], }, }) cdsl["features"].append({ "id": "surface_extrude", "atomic_id": "extrude_surface", "depends_on": ["base_add"], "sketch_id": "surface_profile", "params": {"distance_mm": 10}, }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "surface-extrude.step") surface = next(item for item in result["feature_results"] if item["feature_id"] == "surface_extrude") self.assertNotIn("body_id", surface) self.assertEqual(surface["surface_id"], "surface:surface_extrude") self.assertEqual(result["solid_count"], 1) self.assertAlmostEqual(result["volume_mm3"], 1000.0) faces = [ item for item in result["topology_records"] if item["feature_id"] == "surface_extrude" and item["kind"] == "face" ] self.assertEqual(len(faces), 1) def test_extrude_surface_exports_a_surface_only_step(self) -> None: from build123d import import_step from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "surface-only", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "surface_profile", "workplane": _workplane(), "profile": { "type": "analytic_contours", "contours": [{ "role": "unknown", "closed": True, "segments": [{"type": "circle", "center": [5, 5], "radius_mm": 2}], }], }, }]}, "features": [{ "id": "surface_extrude", "atomic_id": "extrude_surface", "depends_on": [], "sketch_id": "surface_profile", "params": {"distance_mm": 10}, }], } with tempfile.TemporaryDirectory() as directory: out_step = Path(directory) / "surface-only.step" result = rebuild_cdsl(cdsl, out_step) rebuilt = import_step(str(out_step)) self.assertEqual(result["solid_count"], 0) self.assertEqual(result["surface_count"], 1) self.assertEqual(result["surface_face_count"], 1) self.assertAlmostEqual(result["volume_mm3"], 0.0) self.assertAlmostEqual(result["surface_area_mm2"], 40 * math.pi) self.assertEqual(len(rebuilt.solids()), 0) self.assertEqual(len(rebuilt.faces()), 1) def test_extrude_surface_preserves_an_explicit_open_source_wire(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "surface-wire", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "surface_wire", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [{ "role": "open", "closed": False, "surface_wire": True, "segments": [{"type": "line", "start": [0, 0], "end": [10, 0]}], }]}, }]}, "features": [{ "id": "surface_extrude", "atomic_id": "extrude_surface", "depends_on": [], "sketch_id": "surface_wire", "params": {"distance_mm": 5}, }], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "surface-wire.step") self.assertEqual(result["solid_count"], 0) self.assertEqual(result["surface_count"], 1) self.assertEqual(result["surface_face_count"], 1) self.assertAlmostEqual(result["surface_area_mm2"], 50.0) def test_extrude_surface_preserves_connected_and_disconnected_open_source_wires(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "surface-wires", "meta": {"unit": "mm"}, "geometry": {"sketches": [{ "id": "surface_wires", "workplane": _workplane(), "profile": {"type": "analytic_contours", "contours": [ { "role": "open", "closed": False, "surface_wire": True, "segments": [ {"type": "line", "start": [0, 0], "end": [10, 0]}, {"type": "line", "start": [10, 0], "end": [10, 10]}, ], }, { "role": "open", "closed": False, "surface_wire": True, "segments": [{"type": "line", "start": [20, 0], "end": [26, 0]}], }, ]}, }]}, "features": [{ "id": "surface_extrude", "atomic_id": "extrude_surface", "depends_on": [], "sketch_id": "surface_wires", "params": {"distance_mm": 5}, }], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "surface-wires.step") self.assertEqual(result["solid_count"], 0) self.assertEqual(result["surface_count"], 1) self.assertEqual(result["surface_face_count"], 3) self.assertAlmostEqual(result["surface_area_mm2"], 130.0) def test_surface_limited_chamfer_requires_an_explicit_shell_boundary(self) -> None: from build123d import Plane, Solid from cdsl_engine.build123d_adapter import Build123dGeometryAdapter adapter = Build123dGeometryAdapter() base = Solid.make_cylinder(19, 20, Plane(origin=(0, 0, -10))).cut( Solid.make_cylinder(16, 20, Plane(origin=(0, 0, -10))), ) lower = Solid.make_cylinder(28.5, 20, Plane(origin=(0, 0, -20))).cut( Solid.make_cylinder(16, 20, Plane(origin=(0, 0, -20))), ) upper = Solid.make_cylinder(25.5, 25, Plane(origin=(0, 0, 10))).cut( Solid.make_cylinder(17.5, 25, Plane(origin=(0, 0, 10))), ) body = adapter.fuse(adapter.fuse(base, lower), upper) selected = [ edge for edge in body.edges() if str(edge.geom_type).split(".")[-1].lower() == "circle" and abs(float(edge.radius) - 28.5) <= 1e-6 and abs(edge.arc_center.Z) <= 1e-6 ] self.assertEqual(len(selected), 1) with self.assertRaisesRegex(ValueError, "explicit surface support"): adapter.surface_limited_chamfer(body, 10, selected, []) wire = adapter._circle_wire([0, 0], 19, PlaneSpec.from_mapping(_workplane())) support = adapter.extrude_surface([wire], [0, 0, 10]) rebuilt = adapter.surface_limited_chamfer(body, 10, selected, [support]) self.assertLess(rebuilt.volume, body.volume) cones = [face for face in rebuilt.faces() if str(face.geom_type).split(".")[-1].lower() == "cone"] self.assertEqual(len(cones), 1) def test_unowned_revolve_feature_selector_is_preflight_blocked(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = json.loads((ROOT / "json_to_cdsl" / "output" / "027784.cdsl.json").read_text(encoding="utf-8")) analysis = analyze_cdsl(cdsl) revolve = next(item for item in analysis.feature_results if item.feature_id == "f_007") self.assertIn("missing_revolve_axis", [item.code for item in revolve.blockers]) def test_tangent_propagation_does_not_expand_to_unrelated_box_edges(self) -> None: from build123d import Box from cdsl_engine.build123d_adapter import Build123dGeometryAdapter body = Box(10, 10, 10) selected = body.edges()[0] expanded = Build123dGeometryAdapter().tangent_edges(body, [selected]) self.assertEqual(len(expanded), 1) self.assertTrue(expanded[0].is_same(selected)) def test_inconsistent_quarter_arc_flags_are_normalized_from_loop_orientation(self) -> None: from cdsl_engine.batch_rebuild import analyze_document fixture = ROOT / "json_to_cdsl" / "output" / "053393.cdsl.json" with tempfile.TemporaryDirectory() as directory: report = analyze_document(fixture, out_step=Path(directory) / "053393.step") self.assertTrue(report["runtime_eligible"]) self.assertTrue(report["built"]) self.assertTrue(report["geometry_verified"]) def test_exported_two_sided_fixture_is_geometry_verified(self) -> None: from cdsl_engine.batch_rebuild import analyze_document fixture = ROOT / "json_to_cdsl" / "output" / "046112.cdsl.json" with tempfile.TemporaryDirectory() as directory: report = analyze_document(fixture, out_step=Path(directory) / "046112.step") self.assertTrue(report["runtime_eligible"]) self.assertTrue(report["built"]) self.assertTrue(report["geometry_verified"]) def test_selector_driven_extrude_extents_require_unique_rebuilt_topology(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() base["geometry"]["sketches"].append({ "id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }) with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") top_face = next( item for item in baseline["topology_records"] if item["kind"] == "face" and item["geometry"]["surface_type"] == "plane" and item["geometry"]["normal"][2] > 0.9 ) top_vertex = next( item for item in baseline["topology_records"] if item["kind"] == "vertex" and item["geometry"]["center_mm"][2] > 9.9 ) for name, end_condition, expected_depth in ( ("surface", {"type": "up_to_surface", "reference": {"kind": "face", "owner_feature_id": "base_add", "geometry": top_face["geometry"]}}, 10.0), ("vertex", {"type": "up_to_vertex", "reference": {"kind": "vertex", "owner_feature_id": "base_add", "geometry": top_vertex["geometry"]}}, 10.0), ("offset", {"type": "offset_from_surface", "reference": {"kind": "face", "owner_feature_id": "base_add", "geometry": top_face["geometry"]}}, 8.0), ("next", {"type": "through_next"}, 10.0), ): cdsl = deepcopy(base) cdsl["features"].append({ "id": f"cut_{name}", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 2 if name == "offset" else 0, "end_condition": end_condition}, "sketch_id": "cut", }) result = rebuild_cdsl(cdsl, root / f"{name}.step") self.assertAlmostEqual(result["volume_mm3"], 1000 - expected_depth * 3.141592653589793, places=5) def test_up_to_vertex_source_datum_does_not_resolve_runtime_topology(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() base["geometry"]["sketches"].append({ "id": "cut", "source_sketch_id": "source_cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }) base["features"].append({ "id": "cut_to_source_vertex", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 0, "end_condition": { "type": "up_to_vertex", "solidworks_code": 5, "reference": { "kind": "source_vertex", "source_sketch_id": "source_cut", "source_entity_id": "E0.end", "point_mm": [0, 0, 10], }, }}, "sketch_id": "cut", }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(base, Path(directory) / "source-vertex.step") self.assertAlmostEqual(result["volume_mm3"], 1000 - 10 * math.pi, places=5) self.assertEqual(result["selector_resolution"], []) def test_up_to_vertex_intersection_requires_one_shared_current_body_vertex(self) -> None: from cdsl_engine.runtime import RuntimeExecutionError, rebuild_cdsl base = self._base_block() base["geometry"]["sketches"].append({ "id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "center": [0, 0], "radius_mm": 1}, }) with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "intersection-baseline.step") faces = [item for item in baseline["topology_records"] if item["kind"] == "face"] top = next(item for item in faces if item["geometry"]["normal"][2] > 0.9) right = next(item for item in faces if item["geometry"]["normal"][0] > 0.9) back = next(item for item in faces if item["geometry"]["normal"][1] > 0.9) def face_selector(face: dict) -> dict: return { "kind": "face", "owner_feature_id": "base_add", "stable_id": f"intersection-{face['record_id']}", "source": "runtime_snapshot", "confidence": 1.0, "geometry": face["geometry"], } cdsl = deepcopy(base) cdsl["features"].append({ "id": "cut_to_intersection", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 0, "end_condition": { "type": "up_to_vertex", "reference": { "kind": "vertex", "owner_feature_id": "base_add", "stable_id": "top-right-back", "source": "runtime_snapshot", "confidence": 1.0, "intersection_of": [face_selector(top), face_selector(right), face_selector(back)], }, }}, "sketch_id": "cut", }) result = rebuild_cdsl(cdsl, root / "intersection.step") self.assertAlmostEqual(result["volume_mm3"], 1000 - 10 * 3.141592653589793, places=5) ambiguous = deepcopy(cdsl) ambiguous["features"][-1]["params"]["end_condition"]["reference"]["intersection_of"] = [ face_selector(right), face_selector(back), ] with self.assertRaises(RuntimeExecutionError) as error: rebuild_cdsl(ambiguous, root / "ambiguous-intersection.step") self.assertEqual(error.exception.diagnostic.code, "intersection_vertex_unresolved") def test_through_next_trims_a_partially_overlapping_profile_to_the_next_body_face(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() base["geometry"]["sketches"].append({ "id": "partial", "workplane": {"origin_mm": [0, 0, 12], "x_dir": [1, 0, 0], "normal": [0, 0, -1]}, "profile": {"type": "polygon", "vertices": [[3, -3], [9, -3], [9, 3], [3, 3]]}, }) base["features"].append({ "id": "partial_add", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "sketch_id": "partial", "params": {"distance_mm": 0, "end_condition": {"type": "through_next"}}, }) with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(base, Path(directory) / "partial-through-next.step") self.assertAlmostEqual(result["volume_mm3"], 1000 + 24, places=5) def test_through_next_keeps_leading_material_before_a_cylindrical_body(self) -> None: from cdsl_engine.runtime import rebuild_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "leading-through-next", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "base", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 10}}, {"id": "lead", "workplane": { "origin_mm": [0, -50, 25], "x_dir": [1, 0, 0], "normal": [0, 1, 0], }, "profile": {"type": "circle", "radius_mm": 2}}, ]}, "features": [ {"id": "base_add", "atomic_id": "extrude_add_blind", "depends_on": [], "params": {"distance_mm": 50}, "sketch_id": "base"}, {"id": "lead_add", "atomic_id": "extrude_add_blind", "depends_on": ["base_add"], "params": {"distance_mm": 0, "end_condition": {"type": "through_next"}, "result_mode": "new_body"}, "sketch_id": "lead"}, ], } with tempfile.TemporaryDirectory() as directory: result = rebuild_cdsl(cdsl, Path(directory) / "leading-through-next.step") self.assertEqual(result["solid_count"], 2) self.assertAlmostEqual(result["bbox_mm"]["min"][1], -50.0, places=5) def test_up_to_surface_from_a_cylindrical_wall_uses_the_next_body_face(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "wall-hole", "meta": {"unit": "mm"}, "geometry": {"sketches": [ {"id": "tube", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 10}}, {"id": "tube_bore", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 7}}, {"id": "wall_hole", "workplane": { "origin_mm": [10, 0, 5], "x_dir": [0, 1, 0], "normal": [-1, 0, 0], }, "profile": {"type": "circle", "radius_mm": 1}}, ]}, "features": [ {"id": "tube_add", "atomic_id": "extrude_add_blind", "depends_on": [], "params": {"distance_mm": 10}, "sketch_id": "tube"}, {"id": "tube_cut", "atomic_id": "extrude_cut_blind", "depends_on": ["tube_add"], "params": {"distance_mm": 10}, "sketch_id": "tube_bore"}, ], } with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "tube.step") outer_face = next( item for item in baseline["topology_records"] if item["kind"] == "face" and item["geometry"]["surface_type"] == "cylinder" and abs(item["geometry"]["radius_mm"] - 10) <= 1e-6 ) cdsl = deepcopy(base) cdsl["features"].append({ "id": "wall_hole_cut", "atomic_id": "extrude_cut_blind", "depends_on": ["tube_cut"], "params": {"distance_mm": 0, "end_condition": {"type": "up_to_surface", "reference": { "kind": "face", "owner_feature_id": "tube_add", "geometry": outer_face["geometry"], }}}, "sketch_id": "wall_hole", }) result = rebuild_cdsl(cdsl, root / "wall-hole.step") self.assertLess(result["volume_mm3"], baseline["volume_mm3"] - 8) self.assertGreater(result["volume_mm3"], baseline["volume_mm3"] - 12) def test_up_to_body_extent_uses_a_uniquely_resolved_body_record(self) -> None: from cdsl_engine.runtime import rebuild_cdsl base = self._base_block() base["geometry"]["sketches"].append({ "id": "cut", "workplane": _workplane(), "profile": {"type": "circle", "radius_mm": 1}, }) with tempfile.TemporaryDirectory() as directory: root = Path(directory) baseline = rebuild_cdsl(base, root / "baseline.step") body = next(item for item in baseline["topology_records"] if item["kind"] == "body") cdsl = deepcopy(base) cdsl["features"].append({ "id": "cut_to_body", "atomic_id": "extrude_cut_blind", "depends_on": ["base_add"], "params": {"distance_mm": 0, "end_condition": { "type": "up_to_body", "reference": { "kind": "body", "owner_feature_id": "base_add", "geometry": body["geometry"], }, }}, "sketch_id": "cut", }) result = rebuild_cdsl(cdsl, root / "up-to-body.step") self.assertAlmostEqual(result["volume_mm3"], 1000 - 10 * 3.141592653589793, places=5) def test_selector_dependent_extent_without_reference_is_preflight_blocked(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["features"][0]["params"]["end_condition"] = {"type": "up_to_surface"} analysis = analyze_cdsl(cdsl) result = analysis.feature_results[0] self.assertIn("missing_extent_reference", [item.code for item in result.blockers]) def test_hole_wizard_unsupported_extent_is_preflight_blocked(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["features"].append({ "id": "hole", "atomic_id": "hole_wizard", "depends_on": ["base_add"], "params": { "hole_type": "plain", "diameter_mm": 2, "depth_mm": 2, "positions": [{"mm": [0, 0, 0]}], "host_face": {"kind": "face"}, "end_condition": {"type": "up_to_surface", "solidworks_code": 0}, }, }) analysis = analyze_cdsl(cdsl) result = next(item for item in analysis.feature_results if item.feature_id == "hole") self.assertIn("unsupported_hole_extent", [item.code for item in result.blockers]) def test_legacy_hole_atomics_have_the_same_host_and_shape_preflight_contract(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = self._base_block() cdsl["features"].append({ "id": "hole", "atomic_id": "hole_counterbore", "depends_on": ["base_add"], "sketch_id": "base", "params": { "diameter_mm": 2, "depth_mm": 3, "positions": [{"mm": [0, 0, 0]}], "counterbore_diameter_mm": 2, "counterbore_depth_mm": 1, }, }) analysis = analyze_cdsl(cdsl) result = next(item for item in analysis.feature_results if item.feature_id == "hole") codes = {item.code for item in result.blockers} self.assertIn("missing_host_face", codes) self.assertIn("invalid_hole_spec", codes) def test_body_mutation_without_a_preceding_solid_is_preflight_blocked(self) -> None: from cdsl_engine.runtime import analyze_cdsl cdsl = { "schema": "cad.cdsl.llm.v1", "schema_version": "1.1.0", "kind": "part", "part_id": "no-body", "meta": {"unit": "mm"}, "geometry": {"sketches": []}, "features": [{ "id": "hole", "atomic_id": "hole_wizard", "depends_on": [], "params": { "hole_type": "plain", "diameter_mm": 2, "depth_mm": 3, "end_condition": {"type": "blind", "solidworks_code": 0}, "positions": [{"mm": [0, 0, 0]}], "host_face": {"frame": _workplane()}, }, }], } result = analyze_cdsl(cdsl).feature_results[0] self.assertIn("missing_active_body", [item.code for item in result.blockers]) if __name__ == "__main__": unittest.main()