Port the runtime-tracer half of PR #30 (feat/cadquery_converter) and rewrite
its emission layer to the current Feature Tree Convention, following the
tools/research/histjson four-stage pattern (trace / translate / validate /
profile + responsibility wall: the translator only translates).
- tracer/ (instrument, fingerprint, cq_runner, worker) ported near-verbatim:
runs under .venv-cq (Python 3.11 + cadquery 2.8); records resolved plane
frames, serialized args, selector strings, and geometric fingerprints of
actually-selected faces/edges plus ground-truth volume/bbox per program.
- emission rewritten for FTC: block headers with closed role vocabulary and
no positional slugs; transcribed planar profiles authored through the
sketch API (local coords, pooled points, three-point arcs via
circumcenter) annotated profile=geometry; booleans in list form over a
histjson-shaped bodies dataflow; fillet/chamfer/shell selections
synthesized as QL predicate bands from trace fingerprints with
take/exactly cardinality; through-cut depths derived from the trace
bbox; zero in-source verification; literal numbers only.
- unknown ops become untranslated notes, never silent drops; static-AST
path and exploratory scoring/edit-bench from the PR intentionally not
ported.
- directory named cadqueryftc so it can never shadow `import cadquery`.
- fixtures are real traces captured with cadquery 2.8; 13 tests pin format
contracts + volume reconciliation (all four reconcile at <=2.2e-12 rel
err) with no cadquery required in CI; full test/ suite 1516 passed.