6. Layering scheme

kerfmaster pin list · UI / workflow decisions

intentmixedWhat we want to build. Never claimed the present, so it cannot be stale — and must never be read as a description of the code.

Content last changed 2026-08-03 — computed from the item itself, not typed.

Contract — Report stage

This contract describes a stage we intend to build — it is NOT a description of the code.

takes healed-geometrytopology

makes delivery

fails if A generated layer a CAD package will not render; our work indistinguishable from the original.

Contract last changed 2026-08-06 — computed, not typed. Dated separately from the text above, so neither date can speak for the other.

Intent. The interface will show the work as toggleable layers over the original; the final layer set and how they stack is still open. What exists today (2026-08-03) is two boards, and they disagree on the house rule. The vector board has real toggles — srclayer, fitlayer, hazlayer, each with a checkbox (build_vec_board.py:215-217, 364-372); the speck group exists but has no checkbox. The DXF board writes the source straight into the SVG with no group id (build_board.py:195) and offers one checkbox, for the bridge / spacing mark-up. So the base-layer rule is met on one board and not the other.

Layers on the table

Original — the customer file as received; thick gray, the base layer (house style — always the reference).
Healed — clean lines + true arcs, overlaid on top.
QC flags — red markers on anomalies (open contours, duplicates, branches, islands).
QC fix — the proposed auto-corrections (item ‘QC step 2’), a separate deletable layer.
Cut vs Engrave — separate outputs once we can tell them apart (item 8).
Tabs and Leads — already real, in the cut-path review DXF rather than in an interface: cutpath_dxf.LAYERS writes CUT, LEAD, PIERCE, SEQ, DIR, RAPID, RAPID_HAZARD, HELD, LEGEND, TAB, TIP_ARM, TIP_CENTRE. This list is far behind the code; a speck layer is the one named overlay that does not exist.

Open

Which layers are on by default.
How they map to real DXF layers on export (item 10).
Whether QC-flag and QC-fix are one toggle or two.