e12758ff91
The oracle no longer uses Fusion measurements. tests/oracle/<case>/ now holds the 76 recipes (our own format, with recorded measurements and tool-specific fields removed) and an expected.json per case: - 55 analytic cases: closed-form values from tools/oracle-analytic/ (stdlib Python, formulas in each case's "method"). - 21 FreeCAD cases: the same recipe built with FreeCAD's public scripting API by tools/freecad-oracle/ (an external program, not a dependency), with a reference.stl for 20. solvecraft-cli oracle compares body count, volume, area, centre of mass, bbox, face counts where the geometry fixes them, and, against reference.stl, the sampled Hausdorff distance and the principal moments (spatial.rs from #301). cargo xtask oracle reads tests/oracle, writes docs/oracle.md with the source of each value, and supports known_failure marks for tracked bugs. CI runs it on every PR; a manual workflow regenerates the FreeCAD values. step-corpus, seam normalisation and the through-all emulation, which only existed to compare with Fusion, are removed. 75/76 pass; 75-sm-bracket-holes is a known failure (#296). Claude-Session: https://claude.ai/code/session_01RjGw4gA5ZvKrU8MQP6sBgT Co-authored-by: bherbruck <[email protected]> Co-authored-by: Claude Opus 5.5 <[email protected]>
FreeCAD oracle
Reference values for some of the cases in tests/oracle/ are computed by
building the case's own recipe.json a second time, in a different kernel: FreeCAD
(OpenCASCADE). Those cases have "source": "freecad <version>" in their expected.json.
The cases with closed-form answers are worked out by hand instead ("source": "analytic",
see tools/oracle-analytic/).
FreeCAD is an external tool, not a dependency
FreeCAD is run as a separate program (freecadcmd) that executes build.py through FreeCAD's
public Python scripting API (Part, PartDesign, Sketcher, MeshPart). SolidCraft does not use,
link, vendor or ship any code, library or binary from FreeCAD or OpenCASCADE, and nothing in
this directory is part of the build. FreeCAD's LGPL licence therefore does not apply to
SolidCraft's code. The scripts here are our own; they were written against FreeCAD's public
API documentation only, never its sources.
Only values for our own recipes are produced: the numbers in expected.json (body count,
volume, area, centre of mass, bounding box) and the triangulated surface in reference.stl.
Files
build.py: runs inside FreeCAD. Reads a case'srecipe.jsonand builds the part with FreeCAD's modelling operations, following the meaning SolidCraft gives the recipe (apps/solvecraft-cli/src/recipe.rs): sketches (solved by FreeCAD's sketcher when the recipe constrains them, otherwise at their recorded coordinates), extrude (distance, symmetric, two sides, through all, taper), revolve, sweep, loft, holes (simple, drilled tip, counterbore, countersink), rectangular/circular/path patterns and mirror (each source feature's tool moved and its operation applied again), combine, shell, draft, fillet and chamfer (edges picked nearest the recipe's point, tangent chains followed), split body and construction planes. It then measures the result.emit.py: prints a result or writes it asexpected.json/reference.stl.run.sh: the entry point.
Running it
tools/freecad-oracle/run.sh tests/oracle/17-loft tests/oracle/42-overlapping-patterns # print
tools/freecad-oracle/run.sh --write tests/oracle/17-loft # write
Without --write each case prints one line. With --write it writes <case>/expected.json
(source, method, body_count, volume_mm3, area_mm2, center_of_mass, bbox from
optimalBoundingBox()) and <case>/reference.stl (binary, linear deflection 0.005 to 0.02 mm,
at most about 400 KB; when that is not possible the STL is skipped and note says so). It never
overwrites an expected.json whose source is analytic. Per-case comparison settings
(compare, tolerance, note) live in CASE_META in build.py.
freecadcmd is found through $FREECADCMD, then freecadcmd on PATH, then an AppImage
extracted in this directory (squashfs-root/, ignored by git). Locally: install FreeCAD 1.x from your distribution or extract the
AppImage (./FreeCAD_*.AppImage --appimage-extract) and point FREECADCMD at
squashfs-root/usr/bin/freecadcmd. In CI (Debian/Ubuntu): apt install freecad, then run the
script; it needs no display.
The values were produced with FreeCAD 1.1.4. A different FreeCAD version may differ in the last
digits; regenerate only when a recipe changes, and check the new values against SolidCraft
(solvecraft-cli oracle) before committing them.