# Reproduction commands and release gate

Prefix from the repository root:

```sh
build/build_common/python/bin/python3 build/build_tools/python_runner.py build/build_common/modulus
```

The commands below go after that prefix. They write only the consolidated repair directory. Existing published assets and the baseline remain separate.

```sh
-m unittest discover -s tests -p 'test_*.py'
-m audition.dependency_check --output build/solo_reference_comparison/repair/dependency
```

Development-only derivation/fitting (use `explain` instead of `fit` for coverage alone):

```sh
-m audition.fit_selection fit --passes 200 \
 --source all_me_a=data/songs/all-of-me.xml --source all_me_e=data/songs/all-of-me.xml \
 --source autumn_a=data/songs/autumn_leaves.xml --source autumn_e=data/songs/autumn_leaves.xml \
 --reference all_me_a=build/all-of-me-solo-1.xml --reference all_me_e=build/all-of-me-solo-2.xml \
 --reference autumn_a=build/autumn-leaves-solo-1.xml --reference autumn_e=build/autumn-leaves-solo-2.xml \
 --role all_me_a=acoustic_solo --role all_me_e=electric_solo \
 --role autumn_a=acoustic_solo --role autumn_e=electric_solo \
 --form-start all_me_a=1 --form-start all_me_e=1 --form-start autumn_a=2 --form-start autumn_e=2 \
 --cache-dir build/solo_reference_comparison/repair/cache --output build/solo_reference_comparison/repair/fitting
```

Production stage (no reference arguments):

```sh
-m generator --data-dir data --output-dir build/solo_reference_comparison/repair/staged \
 --static-assets-dir package/assets --check --jobs 2 --composition-jobs 2 \
 --composition-cache build/solo_reference_comparison/repair/cache \
 --engraving-cache build/build_common/engraving_cache --export-solo-xml --trace-level full \
 --profile-output build/solo_reference_comparison/repair/build-profile.json --progress
```

Exact gate after generation:

```sh
-m audition.solo_compare --generated-dir build/solo_reference_comparison/repair/staged/solo_xml \
 --reference all_of_me/acoustic=build/all-of-me-solo-1.xml --reference all_of_me/electric=build/all-of-me-solo-2.xml \
 --reference autumn_leaves/acoustic=build/autumn-leaves-solo-1.xml --reference autumn_leaves/electric=build/autumn-leaves-solo-2.xml \
 --form-start all_of_me/acoustic=1 --form-start all_of_me/electric=1 \
 --form-start autumn_leaves/acoustic=2 --form-start autumn_leaves/electric=2 \
 --reference-pitch guitar-written --output build/solo_reference_comparison/repair/comparison --require-exact
```

`--require-exact` returns 1 on any sounding-event/rest mismatch; it does not reinterpret a similar style as success. Add `--assets <completed-assets>` for consistent neutral rendering. A failed fit or exact gate is not permission to copy targets, promote a target-constrained derivation, or publish a mismatched stage. Normal CMake publication is intentionally deferred until the approved acceptance gate passes.

Individual roles remain available through `-m generator.compose --song ... --role acoustic_solo --data-dir data --cache-dir ... --output ... --solo-xml ...`. Use `-m audition.benchmark --source ... --role ... --cache ... --output ...` for an isolated measurement after other builds/tests/fits stop. Profiling changes measured runtime; do not compare a cProfile run to an unprofiled build as a speedup ratio.