10.2. Generation and Candidate Problems
Mix generation must fill the exact requested track count. If it cannot, the current tracklist is left unchanged. Common causes include:
- Too few ready and unique tracks in the selected groups
- A focused transition profile with too few compatible edges
- A strict BPM rule or narrow pitch-shift range
- Allowed roots or modes that exclude most of the Library
- Required stable or changing start/end keys
- Locked positions that cannot be connected
- Position, segment, or whole-Mix exclusions
Gem Finder intentionally ignores Mix groups and exclusions, but it still requires an unused track that passes BPM, Allowed Keys, key matching, and any start/end relationship requirement. A shared candidate can be planned but not auditioned until local audio is added normally.