forgecad-reconstruct-cad-file

Inspect the STL with the ForgeCAD CLI to gather stats, renders, and sections, then rebuild the geometry with blueprint-first parametric APIs in a .forge.js file. Iterate by running forgecad compare 3d against the source until coverage, RMS, and bounds metrics meet the target score.

The reconstruction workflow accepts STL, OBJ, 3MF, STEP, and STP files as source evidence. For 3MF files, every build item must be enumerated before scoring because hidden multi-part structure is a common miss.

No. Imports of the source file are for measurement, rendering, and scoring only, not the deliverable. The final model must be real parametric geometry built with blueprint-first APIs, unless the user explicitly asks for an import wrapper.

Target 95 or higher for simple prismatic or revolved parts, 90 or higher for ordinary mechanical parts with fillets and cutouts, and 80 or above for organic or faceted sources. Always report raw RMS, p95, max, coverage, bounds delta, and volume delta alongside the overall score.

Use --align center-scale only for exploratory diagnosis because it hides dimensional errors. Start with --align none, and use --align center only when origins clearly differ but scale and orientation match.

If the goal is to keep the source file as a live component and design around it, such as a bracket or enclosure, use the forgecad-build-model workflow instead. Prepared benchmark episodes and inspection-bundle interpretation also route to their own dedicated skills.