Research tools

Start with current status. The supported research entrypoint is python -m experiments.baseline --help: the guarded retry control, with separate motion checks and exact replay. It is not a completed puzzle.

Reusable modules:

Module Responsibility
numerical_geometry, native_geometry Numerical polyhedra, reference/native kernels, benchmark helpers
matching, search_geometry Rigid matches, subtraction, numerical audits
search_state State, splitting, rollback/repair primitives, saved geometry
numerical_proposals, boundary_proposals Numerical cut/pose proposal machinery
search_components Shared guarded search and historical comparison modes
assembly_guidance, paired_guidance Independent numerical removal and proposal screens
exact_replay, certification/ Exact reconstruction and independent acceptance checks
state_io, artifact_paths, rollback Saved-state loading, archive aliases, rollback control

Other diagnostics and proposal libraries remain active dependencies. Shared historical modes are retained for comparisons; only the guarded retry is the documented baseline. The original ten campaign runners live in archive. The browser demos are independent of these Python entrypoints.

Run the reference suite with uv run --with scipy python -m unittest discover -s tests -p 'test_*.py', or the native suite with uv run --extra native python -m unittest discover -s tests -p 'test_*.py'. Archived runner tests still run: moving a campaign out of the active path does not discard its regression coverage.