product-vamp/docs/composer/data_migration.md

Musical data and code migration

No target XML, target-derived phrase, timing distribution, fitted weight or lookup by song title was added to production. The four references motivated qualitative musical requirements; the new rules are independently authored general operators. Existing sources and accompaniment resources are unchanged.

Resource	Action	Live consumer / reason
data/songs/	Keep unchanged	Canonical source harmony, form and optional head material
data/scales/	Keep 21 patterns	Existing scale mapper and full-duration permission
data/sequences/	Keep 2,954 paths	Exact degree-step vocabulary and endpoint-indexed short routes; no uniform sampling
data/rhythms/	Keep 3,538 snippets	Meter-indexed representatives; file counts do not determine stylistic frequency
composition/rhythms.json	Keep unchanged	Existing nine melodic cells remain consumed; six comping figures and accompaniment seed content preserved
composition/melodic_vocabulary.json	Migrate then remove	Eleven useful cells move to solo.json; prefix traversal/repair operators superseded
composition/grammar.json	Remove	Old feature-preservation/development and scoring contracts no longer construct music
composition/solo.json	Add, schema 1	Parameterized phrase actions, nine atomic rhythm groups, arrivals, rests, contour alternatives, evaluation and deterministic search budgets
composition/harmony.json, lead_ins.json	Keep	Typed colors, suspensions, anticipations, approaches, enclosures and blues validation
composition/roles.json	Replace solo fields only	Action preferences replace compulsory source-feature preferences; accompaniment fields untouched
data/expected/	Keep validation-only	Existing arrangement compatibility checks
Four supplied XML files under build/	Keep untouched	Explicit optional comparison only

Removed composer modules: drafts, enclosures (old post-pass), features, gesture_rhythm, gestures (old repair proposals), leads, motifs, phrasing, planning, realization, references (feature scoring), similarity and themes. Their useful harmonic/event/placement semantics remain in the shared validators and event types, not in a hidden alternate composer.

Tests tied to the removed plan/draft/paraphrase APIs were retired. Independent timing, chord-role, suspended-note, expression, placement, isolation and export tests were retained or migrated. test_phrase_composer.py covers the replacement through its actual constructor. Removed tests are not counted as passing tests.

New material uses the repository MIT license and explicit provenance. No source songs, scale families, physical restrictions or runtime score schemas changed. Diagnostic reports deliberately move to composer-report-3; no draft/refinement stages are fabricated for the new path.