# CADFS to CDSL

Converts the local CADFS FeatureScript RP corpus to self-contained CDSL 1.1,
rebuilds runtime-eligible documents with the current CDSL engine, and compares
the rebuilt B-rep with the source STEP.

```bash
PYTHONPATH=backend:. python -m cadfs_to_cdsl scan
PYTHONPATH=backend:. python -m cadfs_to_cdsl pipeline --sample-id 00000173
PYTHONPATH=backend:. python -m cadfs_to_cdsl pipeline --limit 100 --seed 0
PYTHONPATH=backend:. python -m cadfs_to_cdsl pipeline
```

All stages are resumable. Use `--force` after changing converter behavior.
The original CADFS directory is read-only; generated evidence is written under
`cadfs_to_cdsl/output/samples/<sample_id>/`.

## Full corpus one-command runner

Run the full conversion, rebuild, comparison, and Markdown report with:

```bash
./cadfs_to_cdsl/run_full_rebuild.sh
```

The default is a forced fresh pass. Before it begins, the previous
`cadfs_to_cdsl/output` directory is moved to
`cadfs_to_cdsl/output-history/<timestamp>/`; it is never deleted or mixed
with the new result. Use `--resume` to reuse the existing output without
archiving it, or `--compare-mode strict` for strict acceptance. See
`./cadfs_to_cdsl/run_full_rebuild.sh --help` for worker and timeout options.

## Representative regression pool

Generate the checked-in representative manifest after a full corpus conversion:

```bash
PYTHONPATH=backend:. python -m cadfs_to_cdsl regression-select
```

The selector deterministically covers every observed FeatureScript modeling
operation, sketch entity type, lowered CDSL atomic operation, unsupported
operation, and unsupported engine-capability variant. It records which atomic
operations have a successful engine baseline and which are diagnostic-only;
the latter are never reported as passing builds. A normal engine change has a
small, executable STEP regression command:

```bash
PYTHONPATH=backend:. python -m cadfs_to_cdsl regression --tier engine --stage rebuild
```

The command reruns by default; use `--resume` only to inspect cached results.
Use `--tier conversion --stage convert` to verify feature lowering and
diagnostics, or `--tier all --stage pipeline` for the complete representative
conversion/rebuild/compare pass.  Unsupported CADFS features remain diagnostic
coverage, not expected successful engine builds.