- rename every numbered example (04/08/10/11/7ep scripts, 12/16/20/21 dirs)
to clean names; each example now writes artifacts to its own out/ folder
- examples/README rewritten as a category index (part / assembly / reverse
engineering / FEM); stale run_examples.py reference removed
- flange_plate gains the quickstart FTC part (model.py + external verify.py
+ README); u_link/ap242/flange demo builders read the new asset paths
- ap242_gmsh_volume_mesh gains render_views.py for the demo gallery
fix(artifacts): round-trip-stable geometry fingerprint bounds
AddOptimal bounds wobble by one shape-tolerance quantum between a fresh
shape and the same shape read back from BRep bytes, so definitions sitting
on a quantization cell edge failed every package re-validation. Quantize
bounds at a fixed 1e-4 mm grid, far coarser than the wobble; full suite
green (1503 passed). Stored packages captured before this change must be
recaptured.
Plural topology getters (get_edges/get_faces/get_wires/get_vertices/
get_solids/get_inner_wires/get_edge_occurrences and the Compound
variants) now accept ONLY an index. The no-argument list form raises a
SimpleCADError with migration guidance (enumerate via
ql.<kind>().resolve(shape), pick via get_X(index)). This closes the
selection channel that escapes the graph: Python loops over bare lists
lose the predicate, capture kernel artifacts (the periodic-face seam
edges that broke FCStd translation), and leave no cardinality contract.
- each shape class keeps its enumeration logic as private _iter_<kind>();
indexed picks record geo-select nodes as before (contract test added);
Compound getters gain the same indexed recording they lacked
- _TopologySelectionList (the __getitem__ recording vehicle, which also
made get_X()[i] a silent escape hatch) is retired
- all 109 internal call sites, 165 test call sites, and 31 example call
sites migrated: SDK/tests use the private channel, user-facing
examples use ql.<kind>().resolve(...)
- QL _resolve_scope_items switches to the private channel; scene
contract profile descriptions synced; error strings recommending
bracket indexing rewritten
- skill docs: strict prohibition added to SKILL.md global rules (new
rule 6), core README contract statement rewritten, solid/wire/face/
shell/tagged_mixin pages re-exemplified with QL, geometric-validation
anti-pattern section updated; mirrors rebuilt via tools/skillbuild.py
Gates: full suite 1418 passed / 5 skipped; translator suites 133 passed;
u_link stage verifiers + render check ALL PASS; scadpkg->FCStd
retranslation verified (5 visible deliverables, 167-object editable
tree).
Expression objects leaked into primitive geo metadata (make_cylinder/cone/
sphere) and were rejected by .scadpkg serialization. Write evaluated values
at the source (_operators_geometry) and project Var/Expr to float in
topology snapshots; add parametrized regression for var-driven primitive
positions.
Found during session 01a02469 (arc handle build) as two independent
serialization failures.