feat(cam): StockState + exact tool-engagement angle

patman commented

2026-07-04 02:55:31 +00:00

Owner

PR3a of the adaptive-clearing roadmap: analytic StockState (CCW outer / CW cleared contours, one shared Z plane, enforced) and StockState::engagement — the exact engagement angle in [0, 2pi]: tool circle partitioned at boundary intersections, interval midpoints classified by containment, inside widths summed; skip-error bounded by n*tol and documented. Silent-wrong-answer paths found in review are now loud errors: mixed-Z boundaries -> NotCoplanar, radius <= 100x tolerance -> InvalidCircle, coincident tool/boundary circle -> OnBoundary. Regularity documented honestly (C0, sqrt cusps at tangencies) for the feed-law layer. Cross-checked by 256-sample angular Monte-Carlo proptest. Stacked on patman/cam-query (#51).

patman added 1 commit

2026-07-04 02:55:31 +00:00

feat(cam): StockState + exact tool-engagement angle 06b9fcba4c

Analytic in-process stock (contours, CCW outer / CW cleared) with the
exact engagement angle of a tool circle: partition at boundary
intersections, classify interval midpoints by containment, sum inside
widths. Coplanarity and radius-vs-tolerance are enforced up front so
mixed-Z boundaries and sub-tolerance tools err loudly instead of
returning silently wrong engagement; degenerate coincident-circle
configurations err OnBoundary. Regularity and error bounds documented
for the feed-law layer.

Co-authored-by: patman-assist <patrick-ai@kgroo.co>