head_music 21.1.0 → 23.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (618) hide show
  1. checksums.yaml +4 -4
  2. data/.claude/skills/release/SKILL.md +25 -4
  3. data/.github/workflows/ci.yml +42 -3
  4. data/.gitignore +1 -0
  5. data/.ruby-version +1 -1
  6. data/.rubycritic.yml +7 -0
  7. data/CHANGELOG.md +324 -0
  8. data/CLAUDE.md +13 -9
  9. data/Gemfile +1 -1
  10. data/Gemfile.lock +16 -16
  11. data/README.md +12 -2
  12. data/Rakefile +86 -6
  13. data/bin/guide_grade_corpus.rb +0 -14
  14. data/bin/validate +5 -0
  15. data/head_music.gemspec +1 -1
  16. data/lib/head_music/analysis/circle.rb +1 -8
  17. data/lib/head_music/analysis/diatonic_interval/naming.rb +19 -17
  18. data/lib/head_music/analysis/diatonic_interval.rb +1 -1
  19. data/lib/head_music/analysis/interval_cycle.rb +7 -2
  20. data/lib/head_music/analysis/key_finder/histograms.rb +55 -0
  21. data/lib/head_music/analysis/key_finder/key_path.rb +39 -0
  22. data/lib/head_music/analysis/key_finder.rb +105 -0
  23. data/lib/head_music/analysis/key_profile.rb +82 -0
  24. data/lib/head_music/analysis/key_region.rb +5 -0
  25. data/lib/head_music/analysis/line_of_fifths.rb +52 -0
  26. data/lib/head_music/analysis/motion.rb +14 -11
  27. data/lib/head_music/analysis/note_input/flow_reader.rb +86 -0
  28. data/lib/head_music/analysis/note_input.rb +121 -0
  29. data/lib/head_music/analysis/pitch_speller/compactness.rb +53 -0
  30. data/lib/head_music/analysis/pitch_speller/key_center.rb +73 -0
  31. data/lib/head_music/analysis/pitch_speller/key_centers.rb +65 -0
  32. data/lib/head_music/analysis/pitch_speller/respelling.rb +75 -0
  33. data/lib/head_music/analysis/pitch_speller/sounding.rb +21 -0
  34. data/lib/head_music/analysis/pitch_speller/successors.rb +58 -0
  35. data/lib/head_music/analysis/pitch_speller.rb +107 -0
  36. data/lib/head_music/analysis/sonority.rb +14 -30
  37. data/lib/head_music/analysis/unspelled_note.rb +16 -0
  38. data/lib/head_music/content/bar.rb +69 -10
  39. data/lib/head_music/content/cantus_firmus/example.rb +2 -2
  40. data/lib/head_music/content/chain_link.rb +67 -0
  41. data/lib/head_music/content/comment.rb +1 -16
  42. data/lib/head_music/content/credits.rb +3 -13
  43. data/lib/head_music/content/dynamic_event.rb +35 -0
  44. data/lib/head_music/content/dynamic_events.rb +38 -0
  45. data/lib/head_music/content/flow/bars.rb +56 -0
  46. data/lib/head_music/content/flow/deserializer.rb +123 -25
  47. data/lib/head_music/content/flow/hash_deserializer.rb +30 -8
  48. data/lib/head_music/content/flow/hash_serializer.rb +47 -0
  49. data/lib/head_music/content/flow/navigation.rb +80 -0
  50. data/lib/head_music/content/flow/performance_order.rb +128 -0
  51. data/lib/head_music/content/flow/schema_validation.rb +53 -0
  52. data/lib/head_music/content/flow/schema_values.rb +67 -143
  53. data/lib/head_music/content/flow/timeline.rb +90 -58
  54. data/lib/head_music/content/flow/timeline_serializer.rb +58 -0
  55. data/lib/head_music/content/flow/timeline_spans.rb +68 -0
  56. data/lib/head_music/content/flow/timeline_tempos.rb +169 -0
  57. data/lib/head_music/content/flow/timeline_values.rb +139 -0
  58. data/lib/head_music/content/flow/v4_upgrade.rb +46 -0
  59. data/lib/head_music/content/flow/voice_event_values.rb +165 -0
  60. data/lib/head_music/content/flow.rb +120 -68
  61. data/lib/head_music/content/grace_note.rb +72 -0
  62. data/lib/head_music/content/jump.rb +53 -0
  63. data/lib/head_music/content/layout/realization.rb +20 -13
  64. data/lib/head_music/content/layout/rendering.rb +82 -0
  65. data/lib/head_music/content/layout.rb +17 -61
  66. data/lib/head_music/content/note.rb +9 -8
  67. data/lib/head_music/content/note_event.rb +154 -0
  68. data/lib/head_music/content/part.rb +40 -1
  69. data/lib/head_music/content/player.rb +1 -2
  70. data/lib/head_music/content/position.rb +56 -16
  71. data/lib/head_music/content/project.rb +66 -26
  72. data/lib/head_music/content/publication.rb +3 -27
  73. data/lib/head_music/content/rest_event.rb +45 -0
  74. data/lib/head_music/content/sound_resolver.rb +9 -3
  75. data/lib/head_music/content/span.rb +81 -0
  76. data/lib/head_music/content/spans.rb +50 -0
  77. data/lib/head_music/content/syllable.rb +3 -3
  78. data/lib/head_music/content/tuplet_group/bracketing.rb +77 -0
  79. data/lib/head_music/content/tuplet_group.rb +120 -0
  80. data/lib/head_music/content/tuplet_groups.rb +36 -0
  81. data/lib/head_music/content/voice/continuity.rb +15 -15
  82. data/lib/head_music/content/voice/dynamic_resolver.rb +49 -0
  83. data/lib/head_music/content/voice/melodic_line.rb +3 -3
  84. data/lib/head_music/content/voice/span_anchors.rb +37 -0
  85. data/lib/head_music/content/voice/staff_assignments.rb +56 -0
  86. data/lib/head_music/content/voice.rb +122 -91
  87. data/lib/head_music/content/voice_event/run.rb +50 -0
  88. data/lib/head_music/content/voice_event.rb +230 -0
  89. data/lib/head_music/content/voice_events.rb +60 -0
  90. data/lib/head_music/content/work.rb +3 -21
  91. data/lib/head_music/instruments/instrument.rb +12 -0
  92. data/lib/head_music/instruments/instruments.yml +115 -0
  93. data/lib/head_music/locales/de.yml +29 -0
  94. data/lib/head_music/locales/en.yml +72 -6
  95. data/lib/head_music/locales/en_GB.yml +2 -2
  96. data/lib/head_music/locales/es.yml +29 -0
  97. data/lib/head_music/locales/fr.yml +29 -0
  98. data/lib/head_music/locales/it.yml +29 -0
  99. data/lib/head_music/locales/ru.yml +29 -0
  100. data/lib/head_music/midi/bar_layout.rb +150 -0
  101. data/lib/head_music/midi/bar_pieces.rb +41 -0
  102. data/lib/head_music/midi/budget.rb +102 -0
  103. data/lib/head_music/midi/change_cursor.rb +30 -0
  104. data/lib/head_music/midi/channel_allocator.rb +47 -0
  105. data/lib/head_music/midi/chunk_reader.rb +72 -0
  106. data/lib/head_music/midi/conductor_track.rb +74 -0
  107. data/lib/head_music/midi/events.rb +112 -0
  108. data/lib/head_music/midi/flow_builder.rb +116 -0
  109. data/lib/head_music/midi/hairpin_ramps.rb +110 -0
  110. data/lib/head_music/midi/instrument_map.rb +77 -0
  111. data/lib/head_music/midi/key_changes.rb +45 -0
  112. data/lib/head_music/midi/key_overlaps.rb +48 -0
  113. data/lib/head_music/midi/level_marks.rb +61 -0
  114. data/lib/head_music/midi/lyric_attacher.rb +60 -0
  115. data/lib/head_music/midi/lyric_events.rb +44 -0
  116. data/lib/head_music/midi/meta_reader.rb +70 -0
  117. data/lib/head_music/midi/meter_changes.rb +67 -0
  118. data/lib/head_music/midi/note_pairing.rb +48 -0
  119. data/lib/head_music/midi/note_timing.rb +109 -0
  120. data/lib/head_music/midi/note_values.rb +99 -0
  121. data/lib/head_music/midi/onsets.rb +15 -0
  122. data/lib/head_music/midi/parser.rb +36 -0
  123. data/lib/head_music/midi/part_key.rb +18 -0
  124. data/lib/head_music/midi/part_reading.rb +72 -0
  125. data/lib/head_music/midi/part_source.rb +161 -0
  126. data/lib/head_music/midi/part_track.rb +115 -0
  127. data/lib/head_music/midi/performance_timeline.rb +80 -0
  128. data/lib/head_music/midi/preflight.rb +138 -0
  129. data/lib/head_music/midi/program_changes.rb +37 -0
  130. data/lib/head_music/midi/quantized_note.rb +5 -0
  131. data/lib/head_music/midi/quantizer.rb +106 -0
  132. data/lib/head_music/midi/ramp_turn.rb +26 -0
  133. data/lib/head_music/midi/reader.rb +110 -0
  134. data/lib/head_music/midi/smf.rb +41 -0
  135. data/lib/head_music/midi/sound_keys.rb +32 -0
  136. data/lib/head_music/midi/spelling.rb +74 -0
  137. data/lib/head_music/midi/tempo_changes.rb +121 -0
  138. data/lib/head_music/midi/tempo_inference.rb +143 -0
  139. data/lib/head_music/midi/tempo_steps.rb +112 -0
  140. data/lib/head_music/midi/tick_resolution.rb +44 -0
  141. data/lib/head_music/midi/timeline_reader.rb +105 -0
  142. data/lib/head_music/midi/track_reader.rb +128 -0
  143. data/lib/head_music/midi/velocity_resolver.rb +116 -0
  144. data/lib/head_music/midi/voice_separator.rb +100 -0
  145. data/lib/head_music/midi/writer.rb +64 -0
  146. data/lib/head_music/midi.rb +54 -0
  147. data/lib/head_music/notation/abc/bar_line_writer.rb +86 -0
  148. data/lib/head_music/notation/abc/bar_mark_reader.rb +75 -0
  149. data/lib/head_music/notation/abc/bar_writer.rb +144 -0
  150. data/lib/head_music/notation/abc/beam_adjacency.rb +34 -0
  151. data/lib/head_music/notation/abc/body_lexer.rb +20 -233
  152. data/lib/head_music/notation/abc/broken_rhythm.rb +41 -0
  153. data/lib/head_music/notation/abc/decoration.rb +37 -0
  154. data/lib/head_music/notation/abc/decoration_mapper.rb +102 -0
  155. data/lib/head_music/notation/abc/decoration_writer.rb +30 -0
  156. data/lib/head_music/notation/abc/duration_resolver.rb +5 -3
  157. data/lib/head_music/notation/abc/duration_writer.rb +22 -22
  158. data/lib/head_music/notation/abc/grace_reader.rb +38 -0
  159. data/lib/head_music/notation/abc/grace_scanner.rb +98 -0
  160. data/lib/head_music/notation/abc/grace_writer.rb +38 -0
  161. data/lib/head_music/notation/abc/hairpin_marks.rb +52 -0
  162. data/lib/head_music/notation/abc/header.rb +49 -19
  163. data/lib/head_music/notation/abc/invisible_rests.rb +38 -0
  164. data/lib/head_music/notation/abc/key_mapper.rb +6 -1
  165. data/lib/head_music/notation/abc/line_scanner.rb +251 -0
  166. data/lib/head_music/notation/abc/navigation_tagger.rb +86 -0
  167. data/lib/head_music/notation/abc/opening_fields.rb +63 -0
  168. data/lib/head_music/notation/abc/parser.rb +111 -108
  169. data/lib/head_music/notation/abc/pending_decorations.rb +127 -0
  170. data/lib/head_music/notation/abc/pending_graces.rb +30 -0
  171. data/lib/head_music/notation/abc/pending_note.rb +64 -0
  172. data/lib/head_music/notation/abc/pending_slurs.rb +68 -0
  173. data/lib/head_music/notation/abc/pending_tie.rb +39 -0
  174. data/lib/head_music/notation/abc/pitch_builder.rb +6 -1
  175. data/lib/head_music/notation/abc/pitch_writer.rb +17 -5
  176. data/lib/head_music/notation/abc/position_marks.rb +147 -0
  177. data/lib/head_music/notation/abc/preflight.rb +13 -0
  178. data/lib/head_music/notation/abc/render_plan.rb +35 -0
  179. data/lib/head_music/notation/abc/render_preflight.rb +71 -0
  180. data/lib/head_music/notation/abc/repeat_tagger.rb +31 -2
  181. data/lib/head_music/notation/abc/rest_writer.rb +50 -0
  182. data/lib/head_music/notation/abc/slur_writer.rb +106 -0
  183. data/lib/head_music/notation/abc/tempo_field.rb +72 -0
  184. data/lib/head_music/notation/abc/timeline_fields.rb +54 -0
  185. data/lib/head_music/notation/abc/token.rb +2 -2
  186. data/lib/head_music/notation/abc/tuplet_grouping.rb +104 -0
  187. data/lib/head_music/notation/abc/tuplet_marker.rb +30 -0
  188. data/lib/head_music/notation/abc/tuplet_writer.rb +68 -0
  189. data/lib/head_music/notation/abc/voice_overlay.rb +49 -0
  190. data/lib/head_music/notation/abc/voice_registry.rb +8 -2
  191. data/lib/head_music/notation/abc/voice_replay.rb +45 -0
  192. data/lib/head_music/notation/abc/voice_state.rb +262 -86
  193. data/lib/head_music/notation/abc/voice_tokens.rb +29 -0
  194. data/lib/head_music/notation/abc/voice_writer.rb +125 -0
  195. data/lib/head_music/notation/abc/writer.rb +53 -108
  196. data/lib/head_music/notation/abc.rb +1 -10
  197. data/lib/head_music/notation/bar_map.rb +186 -0
  198. data/lib/head_music/notation/bar_marks.rb +19 -0
  199. data/lib/head_music/notation/bar_splitter.rb +140 -0
  200. data/lib/head_music/notation/barline_placement.rb +15 -0
  201. data/lib/head_music/notation/beam_groups.rb +39 -0
  202. data/lib/head_music/notation/beam_reading.rb +20 -0
  203. data/lib/head_music/notation/chord_clashes.rb +20 -0
  204. data/lib/head_music/notation/clef_changes.rb +21 -0
  205. data/lib/head_music/notation/concert_transposition.rb +60 -0
  206. data/lib/head_music/notation/dotted_duration.rb +63 -23
  207. data/lib/head_music/notation/fermata_marks.rb +78 -0
  208. data/lib/head_music/notation/flow_timed_marks.rb +71 -0
  209. data/lib/head_music/notation/hairpin_segments.rb +22 -0
  210. data/lib/head_music/notation/kern/bar_clock.rb +195 -0
  211. data/lib/head_music/notation/kern/barline_reader.rb +37 -0
  212. data/lib/head_music/notation/kern/chord_token.rb +65 -0
  213. data/lib/head_music/notation/kern/citation_reader.rb +69 -0
  214. data/lib/head_music/notation/kern/clef_codes.rb +33 -0
  215. data/lib/head_music/notation/kern/data_rows.rb +101 -0
  216. data/lib/head_music/notation/kern/document.rb +129 -0
  217. data/lib/head_music/notation/kern/duration_reader.rb +79 -0
  218. data/lib/head_music/notation/kern/duration_writer.rb +38 -0
  219. data/lib/head_music/notation/kern/dynamic_fields.rb +93 -0
  220. data/lib/head_music/notation/kern/dynamic_placer.rb +131 -0
  221. data/lib/head_music/notation/kern/dynamic_reader.rb +88 -0
  222. data/lib/head_music/notation/kern/flow_builder.rb +140 -0
  223. data/lib/head_music/notation/kern/grace_tokens.rb +42 -0
  224. data/lib/head_music/notation/kern/instrument_codes.rb +62 -0
  225. data/lib/head_music/notation/kern/interpretation_reader.rb +43 -0
  226. data/lib/head_music/notation/kern/interpretation_rows.rb +119 -0
  227. data/lib/head_music/notation/kern/key_reader.rb +73 -0
  228. data/lib/head_music/notation/kern/layer.rb +158 -0
  229. data/lib/head_music/notation/kern/lexer.rb +89 -0
  230. data/lib/head_music/notation/kern/lyric_reader.rb +84 -0
  231. data/lib/head_music/notation/kern/mark_codes.rb +48 -0
  232. data/lib/head_music/notation/kern/mark_offset.rb +16 -0
  233. data/lib/head_music/notation/kern/melismas.rb +35 -0
  234. data/lib/head_music/notation/kern/meter_reader.rb +60 -0
  235. data/lib/head_music/notation/kern/parser.rb +34 -0
  236. data/lib/head_music/notation/kern/part_grouping.rb +70 -0
  237. data/lib/head_music/notation/kern/part_roster.rb +69 -0
  238. data/lib/head_music/notation/kern/pitch_reader.rb +32 -0
  239. data/lib/head_music/notation/kern/pitch_writer.rb +21 -0
  240. data/lib/head_music/notation/kern/preflight.rb +84 -0
  241. data/lib/head_music/notation/kern/record.rb +26 -0
  242. data/lib/head_music/notation/kern/reference_records.rb +64 -0
  243. data/lib/head_music/notation/kern/render_plan.rb +19 -0
  244. data/lib/head_music/notation/kern/row_offsets.rb +30 -0
  245. data/lib/head_music/notation/kern/span_marks.rb +80 -0
  246. data/lib/head_music/notation/kern/spine_changes.rb +78 -0
  247. data/lib/head_music/notation/kern/spine_columns.rb +86 -0
  248. data/lib/head_music/notation/kern/spine_layout.rb +151 -0
  249. data/lib/head_music/notation/kern/spine_tags.rb +30 -0
  250. data/lib/head_music/notation/kern/spine_tokens.rb +183 -0
  251. data/lib/head_music/notation/kern/spine_voices.rb +127 -0
  252. data/lib/head_music/notation/kern/tempo_reader.rb +49 -0
  253. data/lib/head_music/notation/kern/timeline_reader.rb +169 -0
  254. data/lib/head_music/notation/kern/token_reader.rb +198 -0
  255. data/lib/head_music/notation/kern/tuplet_groups.rb +93 -0
  256. data/lib/head_music/notation/kern/voice_cursor.rb +115 -0
  257. data/lib/head_music/notation/kern/writer.rb +67 -0
  258. data/lib/head_music/notation/kern/written_bars.rb +151 -0
  259. data/lib/head_music/notation/kern.rb +27 -0
  260. data/lib/head_music/notation/lily_pond/bar_commands.rb +87 -0
  261. data/lib/head_music/notation/lily_pond/bar_mark_placer.rb +82 -0
  262. data/lib/head_music/notation/lily_pond/bar_mark_reader.rb +134 -0
  263. data/lib/head_music/notation/lily_pond/bar_mark_writer.rb +65 -0
  264. data/lib/head_music/notation/lily_pond/chord_reader.rb +34 -0
  265. data/lib/head_music/notation/lily_pond/context_reader.rb +58 -12
  266. data/lib/head_music/notation/lily_pond/document.rb +32 -1
  267. data/lib/head_music/notation/lily_pond/duration_reader.rb +41 -3
  268. data/lib/head_music/notation/lily_pond/duration_writer.rb +3 -3
  269. data/lib/head_music/notation/lily_pond/dynamics_item_reader.rb +47 -0
  270. data/lib/head_music/notation/lily_pond/event_placer.rb +191 -0
  271. data/lib/head_music/notation/lily_pond/flow_builder.rb +20 -95
  272. data/lib/head_music/notation/lily_pond/grace_reader.rb +132 -0
  273. data/lib/head_music/notation/lily_pond/grace_writer.rb +35 -0
  274. data/lib/head_music/notation/lily_pond/group_reader.rb +51 -0
  275. data/lib/head_music/notation/lily_pond/hairpin_marks.rb +40 -0
  276. data/lib/head_music/notation/lily_pond/key_mapper.rb +2 -11
  277. data/lib/head_music/notation/lily_pond/lexer.rb +92 -12
  278. data/lib/head_music/notation/lily_pond/mark_reader.rb +184 -0
  279. data/lib/head_music/notation/lily_pond/mark_writer.rb +27 -0
  280. data/lib/head_music/notation/lily_pond/music_item_reader.rb +85 -57
  281. data/lib/head_music/notation/lily_pond/music_reader.rb +29 -33
  282. data/lib/head_music/notation/lily_pond/part_dynamics.rb +53 -0
  283. data/lib/head_music/notation/lily_pond/part_layout.rb +71 -0
  284. data/lib/head_music/notation/lily_pond/pending_tuplets.rb +47 -0
  285. data/lib/head_music/notation/lily_pond/pitch_writer.rb +18 -0
  286. data/lib/head_music/notation/lily_pond/preflight.rb +27 -20
  287. data/lib/head_music/notation/lily_pond/render_plan.rb +94 -24
  288. data/lib/head_music/notation/lily_pond/segment_tokens.rb +135 -0
  289. data/lib/head_music/notation/lily_pond/setting_reader.rb +86 -0
  290. data/lib/head_music/notation/lily_pond/spacer_run.rb +43 -0
  291. data/lib/head_music/notation/lily_pond/spacers.rb +58 -0
  292. data/lib/head_music/notation/lily_pond/span_marks.rb +91 -0
  293. data/lib/head_music/notation/lily_pond/span_pairing.rb +35 -0
  294. data/lib/head_music/notation/lily_pond/tempo_reader.rb +46 -0
  295. data/lib/head_music/notation/lily_pond/tempo_writer.rb +33 -0
  296. data/lib/head_music/notation/lily_pond/time_signature_writer.rb +42 -0
  297. data/lib/head_music/notation/lily_pond/timed_marks.rb +158 -0
  298. data/lib/head_music/notation/lily_pond/token.rb +8 -2
  299. data/lib/head_music/notation/lily_pond/token_cursor.rb +55 -2
  300. data/lib/head_music/notation/lily_pond/tuplet_reader.rb +56 -0
  301. data/lib/head_music/notation/lily_pond/voice_context.rb +21 -9
  302. data/lib/head_music/notation/lily_pond/voice_item_reader.rb +86 -0
  303. data/lib/head_music/notation/lily_pond/voice_stream.rb +172 -34
  304. data/lib/head_music/notation/lily_pond/voice_writer.rb +89 -38
  305. data/lib/head_music/notation/lily_pond/writer.rb +30 -15
  306. data/lib/head_music/notation/lily_pond.rb +4 -7
  307. data/lib/head_music/notation/mark_reading.rb +16 -0
  308. data/lib/head_music/notation/mei/accidental_plan.rb +94 -0
  309. data/lib/head_music/notation/mei/accidental_reading.rb +23 -0
  310. data/lib/head_music/notation/mei/artic_attributes.rb +36 -0
  311. data/lib/head_music/notation/mei/artic_reader.rb +41 -0
  312. data/lib/head_music/notation/mei/attached_marks.rb +70 -0
  313. data/lib/head_music/notation/mei/attribute_values.rb +245 -0
  314. data/lib/head_music/notation/mei/bar_marks.rb +52 -0
  315. data/lib/head_music/notation/mei/barline_reader.rb +101 -0
  316. data/lib/head_music/notation/mei/beam_containers.rb +56 -0
  317. data/lib/head_music/notation/mei/beam_reader.rb +79 -0
  318. data/lib/head_music/notation/mei/clef_reading.rb +34 -0
  319. data/lib/head_music/notation/mei/container_spans.rb +15 -0
  320. data/lib/head_music/notation/mei/control_anchors.rb +194 -0
  321. data/lib/head_music/notation/mei/copy_expansion.rb +113 -0
  322. data/lib/head_music/notation/mei/decimals.rb +29 -0
  323. data/lib/head_music/notation/mei/document.rb +138 -0
  324. data/lib/head_music/notation/mei/downbeat_tempo.rb +41 -0
  325. data/lib/head_music/notation/mei/duration_reading.rb +49 -0
  326. data/lib/head_music/notation/mei/durations.rb +31 -0
  327. data/lib/head_music/notation/mei/dynam_reader.rb +51 -0
  328. data/lib/head_music/notation/mei/editorial.rb +122 -0
  329. data/lib/head_music/notation/mei/ending_passes.rb +24 -0
  330. data/lib/head_music/notation/mei/event_records.rb +61 -0
  331. data/lib/head_music/notation/mei/event_writer.rb +102 -0
  332. data/lib/head_music/notation/mei/fermata_controls.rb +39 -0
  333. data/lib/head_music/notation/mei/fermata_reader.rb +43 -0
  334. data/lib/head_music/notation/mei/flow_builder.rb +62 -0
  335. data/lib/head_music/notation/mei/hairpin_reader.rb +38 -0
  336. data/lib/head_music/notation/mei/head_writer.rb +85 -0
  337. data/lib/head_music/notation/mei/id_index.rb +86 -0
  338. data/lib/head_music/notation/mei/identity_reader.rb +199 -0
  339. data/lib/head_music/notation/mei/ids.rb +70 -0
  340. data/lib/head_music/notation/mei/layer_containers.rb +94 -0
  341. data/lib/head_music/notation/mei/layer_reader.rb +211 -0
  342. data/lib/head_music/notation/mei/layer_signs.rb +37 -0
  343. data/lib/head_music/notation/mei/layer_tree.rb +40 -0
  344. data/lib/head_music/notation/mei/lyric_reader.rb +116 -0
  345. data/lib/head_music/notation/mei/lyric_writer.rb +72 -0
  346. data/lib/head_music/notation/mei/mark_reader.rb +52 -0
  347. data/lib/head_music/notation/mei/mark_readers.rb +18 -0
  348. data/lib/head_music/notation/mei/mark_records.rb +122 -0
  349. data/lib/head_music/notation/mei/marking_events.rb +89 -0
  350. data/lib/head_music/notation/mei/markup.rb +37 -0
  351. data/lib/head_music/notation/mei/measure_clefs.rb +38 -0
  352. data/lib/head_music/notation/mei/measure_contents.rb +87 -0
  353. data/lib/head_music/notation/mei/measure_length.rb +30 -0
  354. data/lib/head_music/notation/mei/measure_writer.rb +79 -0
  355. data/lib/head_music/notation/mei/navigation_events.rb +59 -0
  356. data/lib/head_music/notation/mei/navigation_reader.rb +71 -0
  357. data/lib/head_music/notation/mei/onset_index.rb +49 -0
  358. data/lib/head_music/notation/mei/open_spaces.rb +43 -0
  359. data/lib/head_music/notation/mei/opening_values.rb +44 -0
  360. data/lib/head_music/notation/mei/ornament_reader.rb +47 -0
  361. data/lib/head_music/notation/mei/parser.rb +45 -0
  362. data/lib/head_music/notation/mei/part_layers.rb +58 -0
  363. data/lib/head_music/notation/mei/part_reading.rb +69 -0
  364. data/lib/head_music/notation/mei/part_roster.rb +54 -0
  365. data/lib/head_music/notation/mei/part_spelling.rb +55 -0
  366. data/lib/head_music/notation/mei/pitch_reading.rb +33 -0
  367. data/lib/head_music/notation/mei/preflight.rb +63 -0
  368. data/lib/head_music/notation/mei/render_plan.rb +154 -0
  369. data/lib/head_music/notation/mei/score_def_values.rb +84 -0
  370. data/lib/head_music/notation/mei/score_def_writer.rb +138 -0
  371. data/lib/head_music/notation/mei/score_reader.rb +191 -0
  372. data/lib/head_music/notation/mei/section_writer.rb +48 -0
  373. data/lib/head_music/notation/mei/slur_reader.rb +71 -0
  374. data/lib/head_music/notation/mei/staff_groups.rb +132 -0
  375. data/lib/head_music/notation/mei/staff_numbering.rb +62 -0
  376. data/lib/head_music/notation/mei/staff_state.rb +207 -0
  377. data/lib/head_music/notation/mei/tempo_controls.rb +103 -0
  378. data/lib/head_music/notation/mei/tempo_mark_reader.rb +79 -0
  379. data/lib/head_music/notation/mei/tempo_reading.rb +40 -0
  380. data/lib/head_music/notation/mei/tie_controls.rb +145 -0
  381. data/lib/head_music/notation/mei/timeline_changes.rb +119 -0
  382. data/lib/head_music/notation/mei/timeline_reader.rb +30 -0
  383. data/lib/head_music/notation/mei/tstamp.rb +56 -0
  384. data/lib/head_music/notation/mei/tuplet_reader.rb +35 -0
  385. data/lib/head_music/notation/mei/tuplet_spans.rb +173 -0
  386. data/lib/head_music/notation/mei/voice_assignment.rb +109 -0
  387. data/lib/head_music/notation/mei/writer.rb +59 -0
  388. data/lib/head_music/notation/mei/written_items.rb +112 -0
  389. data/lib/head_music/notation/mei/xml_reading.rb +5 -0
  390. data/lib/head_music/notation/mei.rb +69 -0
  391. data/lib/head_music/notation/melisma_fill.rb +22 -0
  392. data/lib/head_music/notation/music_xml/attributes_reader.rb +103 -0
  393. data/lib/head_music/notation/music_xml/attributes_writer.rb +62 -41
  394. data/lib/head_music/notation/music_xml/barline_reader.rb +121 -0
  395. data/lib/head_music/notation/music_xml/barline_writer.rb +102 -0
  396. data/lib/head_music/notation/music_xml/beam_grouper.rb +10 -40
  397. data/lib/head_music/notation/music_xml/beam_reader.rb +46 -0
  398. data/lib/head_music/notation/music_xml/clef_reader.rb +20 -0
  399. data/lib/head_music/notation/music_xml/direction_marks.rb +51 -0
  400. data/lib/head_music/notation/music_xml/direction_plan.rb +135 -0
  401. data/lib/head_music/notation/music_xml/direction_reader.rb +142 -0
  402. data/lib/head_music/notation/music_xml/direction_writer.rb +73 -0
  403. data/lib/head_music/notation/music_xml/divisions.rb +45 -10
  404. data/lib/head_music/notation/music_xml/document.rb +77 -0
  405. data/lib/head_music/notation/music_xml/duration_writer.rb +21 -6
  406. data/lib/head_music/notation/music_xml/fermata_reader.rb +57 -0
  407. data/lib/head_music/notation/music_xml/flow_builder.rb +47 -0
  408. data/lib/head_music/notation/music_xml/grace_writer.rb +85 -0
  409. data/lib/head_music/notation/music_xml/identity_reader.rb +81 -0
  410. data/lib/head_music/notation/music_xml/instrument_sounds.rb +23 -0
  411. data/lib/head_music/notation/music_xml/instrument_sounds.yml +123 -0
  412. data/lib/head_music/notation/music_xml/key_mapper.rb +30 -0
  413. data/lib/head_music/notation/music_xml/lyric_reader.rb +116 -0
  414. data/lib/head_music/notation/music_xml/lyric_writer.rb +50 -29
  415. data/lib/head_music/notation/music_xml/mark_reader.rb +28 -0
  416. data/lib/head_music/notation/music_xml/mark_readers.rb +25 -0
  417. data/lib/head_music/notation/music_xml/mark_records.rb +124 -0
  418. data/lib/head_music/notation/music_xml/marking_elements.rb +65 -0
  419. data/lib/head_music/notation/music_xml/marking_reader.rb +76 -0
  420. data/lib/head_music/notation/music_xml/navigation_reader.rb +91 -0
  421. data/lib/head_music/notation/music_xml/navigation_writer.rb +60 -0
  422. data/lib/head_music/notation/music_xml/note_lines.rb +39 -0
  423. data/lib/head_music/notation/music_xml/note_reader.rb +100 -0
  424. data/lib/head_music/notation/music_xml/note_writer.rb +104 -70
  425. data/lib/head_music/notation/music_xml/parse_preflight.rb +11 -0
  426. data/lib/head_music/notation/music_xml/parser.rb +39 -0
  427. data/lib/head_music/notation/music_xml/part_durations.rb +83 -0
  428. data/lib/head_music/notation/music_xml/part_reader.rb +152 -0
  429. data/lib/head_music/notation/music_xml/part_roster.rb +44 -0
  430. data/lib/head_music/notation/music_xml/part_staves.rb +47 -0
  431. data/lib/head_music/notation/music_xml/part_writer.rb +119 -0
  432. data/lib/head_music/notation/music_xml/pitch_reader.rb +20 -0
  433. data/lib/head_music/notation/music_xml/pitch_writer.rb +13 -0
  434. data/lib/head_music/notation/music_xml/preflight.rb +14 -19
  435. data/lib/head_music/notation/music_xml/render_plan.rb +57 -49
  436. data/lib/head_music/notation/music_xml/slur_numbers.rb +98 -0
  437. data/lib/head_music/notation/music_xml/slur_reader.rb +69 -0
  438. data/lib/head_music/notation/music_xml/tempo_direction.rb +91 -0
  439. data/lib/head_music/notation/music_xml/tempo_reader.rb +127 -0
  440. data/lib/head_music/notation/music_xml/tempo_writer.rb +97 -0
  441. data/lib/head_music/notation/music_xml/timeline_reader.rb +37 -0
  442. data/lib/head_music/notation/music_xml/tuplet_marks.rb +76 -0
  443. data/lib/head_music/notation/music_xml/tuplet_reader.rb +86 -0
  444. data/lib/head_music/notation/music_xml/voice_tracks.rb +129 -0
  445. data/lib/head_music/notation/music_xml/wedge_numbers.rb +46 -0
  446. data/lib/head_music/notation/music_xml/writer.rb +26 -85
  447. data/lib/head_music/notation/music_xml/written_timing.rb +89 -0
  448. data/lib/head_music/notation/music_xml/xml_reading.rb +4 -0
  449. data/lib/head_music/notation/music_xml.rb +33 -1
  450. data/lib/head_music/notation/parse_preflight.rb +85 -0
  451. data/lib/head_music/notation/pitch_spelling.rb +30 -0
  452. data/lib/head_music/notation/preflight_checks.rb +117 -12
  453. data/lib/head_music/notation/render_plan.rb +47 -4
  454. data/lib/head_music/notation/span_ends.rb +11 -0
  455. data/lib/head_music/notation/tempo_mark_reading.rb +130 -0
  456. data/lib/head_music/notation/tempo_marks.rb +95 -0
  457. data/lib/head_music/notation/tie_folding.rb +90 -0
  458. data/lib/head_music/notation/timeline_reading.rb +67 -0
  459. data/lib/head_music/notation/tuplet_brackets.rb +91 -0
  460. data/lib/head_music/notation/voice_event_validation.rb +34 -0
  461. data/lib/head_music/notation/voice_placer.rb +94 -0
  462. data/lib/head_music/notation/voice_track.rb +133 -0
  463. data/lib/head_music/notation/written_links.rb +37 -0
  464. data/lib/head_music/notation/xml_reading.rb +85 -0
  465. data/lib/head_music/notation/xml_text.rb +22 -0
  466. data/lib/head_music/notation.rb +40 -0
  467. data/lib/head_music/rudiment/articulation.rb +10 -0
  468. data/lib/head_music/rudiment/articulations.yml +6 -0
  469. data/lib/head_music/rudiment/chromatic_interval.rb +2 -0
  470. data/lib/head_music/rudiment/clef.rb +6 -0
  471. data/lib/head_music/rudiment/duration_comparison.rb +18 -0
  472. data/lib/head_music/rudiment/dynamic.rb +52 -0
  473. data/lib/head_music/rudiment/dynamics.yml +27 -0
  474. data/lib/head_music/rudiment/key.rb +10 -6
  475. data/lib/head_music/rudiment/key_signature.rb +9 -24
  476. data/lib/head_music/rudiment/keyed_catalog.rb +73 -0
  477. data/lib/head_music/rudiment/letter_name.rb +1 -1
  478. data/lib/head_music/rudiment/meter.rb +31 -4
  479. data/lib/head_music/rudiment/mode.rb +9 -4
  480. data/lib/head_music/rudiment/note.rb +25 -23
  481. data/lib/head_music/rudiment/ornament.rb +9 -0
  482. data/lib/head_music/rudiment/ornaments.yml +13 -0
  483. data/lib/head_music/rudiment/pitch.rb +3 -2
  484. data/lib/head_music/rudiment/pitch_class.rb +2 -0
  485. data/lib/head_music/rudiment/quality.rb +11 -4
  486. data/lib/head_music/rudiment/rest.rb +9 -9
  487. data/lib/head_music/rudiment/rhythm.rb +2 -0
  488. data/lib/head_music/rudiment/rhythmic_duration.rb +114 -0
  489. data/lib/head_music/rudiment/rhythmic_element.rb +10 -11
  490. data/lib/head_music/rudiment/rhythmic_unit/parser.rb +12 -11
  491. data/lib/head_music/rudiment/rhythmic_unit.rb +6 -4
  492. data/lib/head_music/rudiment/rhythmic_value/name_reader.rb +67 -0
  493. data/lib/head_music/rudiment/rhythmic_value.rb +73 -78
  494. data/lib/head_music/rudiment/soundable.rb +11 -0
  495. data/lib/head_music/rudiment/span_kind.rb +52 -0
  496. data/lib/head_music/rudiment/span_kinds.yml +31 -0
  497. data/lib/head_music/rudiment/spelling.rb +1 -1
  498. data/lib/head_music/rudiment/tempo.rb +45 -14
  499. data/lib/head_music/rudiment/tuplet_ratio.rb +84 -0
  500. data/lib/head_music/rudiment/unpitched_note.rb +18 -18
  501. data/lib/head_music/rudiment/unpitched_sound.rb +2 -0
  502. data/lib/head_music/style/guide_item.rb +11 -16
  503. data/lib/head_music/style/guideline/bar_span.rb +40 -0
  504. data/lib/head_music/style/guideline/harmonic_context.rb +15 -11
  505. data/lib/head_music/style/guideline/voice_context.rb +8 -0
  506. data/lib/head_music/style/guideline/wording.rb +5 -0
  507. data/lib/head_music/style/guideline.rb +3 -3
  508. data/lib/head_music/style/guidelines/allow_fifth_species_rhythmic_values.rb +12 -7
  509. data/lib/head_music/style/guidelines/allow_whole_half_quarter_notes.rb +2 -2
  510. data/lib/head_music/style/guidelines/always_move.rb +31 -0
  511. data/lib/head_music/style/guidelines/avoid_crossing_voices.rb +3 -6
  512. data/lib/head_music/style/guidelines/contoured/direction_reading.rb +67 -0
  513. data/lib/head_music/style/guidelines/contoured/turn_reading.rb +66 -0
  514. data/lib/head_music/style/guidelines/contoured/wave_reading.rb +87 -0
  515. data/lib/head_music/style/guidelines/contoured.rb +56 -77
  516. data/lib/head_music/style/guidelines/diatonic.rb +53 -9
  517. data/lib/head_music/style/guidelines/dissonance_figure_detection.rb +35 -58
  518. data/lib/head_music/style/guidelines/embellished_suspension_treatment.rb +36 -0
  519. data/lib/head_music/style/guidelines/first_bar_entry.rb +5 -5
  520. data/lib/head_music/style/guidelines/first_bar_half_notes.rb +2 -2
  521. data/lib/head_music/style/guidelines/first_bar_quarter_notes.rb +2 -2
  522. data/lib/head_music/style/guidelines/first_bar_whole_note.rb +2 -2
  523. data/lib/head_music/style/guidelines/florid_dissonance_treatment.rb +10 -38
  524. data/lib/head_music/style/guidelines/limit_octave_leaps.rb +1 -4
  525. data/lib/head_music/style/guidelines/maximum_notes.rb +1 -6
  526. data/lib/head_music/style/guidelines/minimum_melodic_intervals.rb +2 -9
  527. data/lib/head_music/style/guidelines/minimum_notes.rb +1 -8
  528. data/lib/head_music/style/guidelines/minimum_threshold.rb +3 -1
  529. data/lib/head_music/style/guidelines/mix_species_textures.rb +86 -0
  530. data/lib/head_music/style/guidelines/no_parallel_perfect.rb +7 -2
  531. data/lib/head_music/style/guidelines/no_parallel_perfect_across_barline.rb +5 -36
  532. data/lib/head_music/style/guidelines/no_rests.rb +1 -1
  533. data/lib/head_music/style/guidelines/no_rests_after_note.rb +2 -2
  534. data/lib/head_music/style/guidelines/note_count_per_bar.rb +11 -30
  535. data/lib/head_music/style/guidelines/note_fills_final_bar.rb +1 -1
  536. data/lib/head_music/style/guidelines/notes_same_length.rb +16 -16
  537. data/lib/head_music/style/guidelines/prefer_long_before_short.rb +45 -0
  538. data/lib/head_music/style/guidelines/second_species_break.rb +3 -4
  539. data/lib/head_music/style/guidelines/set_against_another_voice.rb +2 -2
  540. data/lib/head_music/style/guidelines/step_out_of_unison.rb +14 -2
  541. data/lib/head_music/style/guidelines/suspension_treatment.rb +4 -24
  542. data/lib/head_music/style/guidelines/sustain_across_barlines.rb +43 -0
  543. data/lib/head_music/style/guidelines/weak_beat_dissonance_treatment.rb +1 -7
  544. data/lib/head_music/style/guides/base.rb +2 -4
  545. data/lib/head_music/style/guides/composite_guide.rb +2 -4
  546. data/lib/head_music/style/guides/configured.rb +5 -13
  547. data/lib/head_music/style/guides/fifth_species_harmony.rb +1 -1
  548. data/lib/head_music/style/guides/fifth_species_melody.rb +3 -6
  549. data/lib/head_music/style/guides/first_species_melody.rb +2 -8
  550. data/lib/head_music/style/guides/first_three_species_melody.rb +2 -8
  551. data/lib/head_music/style/guides/fourth_species_melody.rb +6 -5
  552. data/lib/head_music/style/guides/second_species_melody.rb +1 -5
  553. data/lib/head_music/style/guides/species_harmony.rb +5 -0
  554. data/lib/head_music/style/guides/species_melody.rb +10 -2
  555. data/lib/head_music/style/guides/third_species_melody.rb +1 -5
  556. data/lib/head_music/style/guides/third_species_triple_meter_melody.rb +1 -5
  557. data/lib/head_music/style/guides/tiered_items.rb +10 -0
  558. data/lib/head_music/style/mark.rb +15 -15
  559. data/lib/head_music/time/a_tempo.rb +23 -0
  560. data/lib/head_music/time/change_map.rb +46 -0
  561. data/lib/head_music/time/conductor.rb +27 -2
  562. data/lib/head_music/time/event_map.rb +16 -9
  563. data/lib/head_music/time/fermata.rb +20 -0
  564. data/lib/head_music/time/key_signature_event.rb +30 -1
  565. data/lib/head_music/time/meter_map.rb +7 -27
  566. data/lib/head_music/time/meter_scale.rb +64 -0
  567. data/lib/head_music/time/musical_position.rb +6 -1
  568. data/lib/head_music/time/musical_time_converter.rb +25 -77
  569. data/lib/head_music/time/tempo_event.rb +11 -4
  570. data/lib/head_music/time/tempo_map.rb +8 -34
  571. data/lib/head_music/time/tempo_piece.rb +69 -0
  572. data/lib/head_music/time/tempo_pieces.rb +112 -0
  573. data/lib/head_music/time/tempo_ramp.rb +34 -0
  574. data/lib/head_music/time.rb +8 -1
  575. data/lib/head_music/value_equality.rb +5 -0
  576. data/lib/head_music/version.rb +1 -1
  577. data/lib/head_music.rb +70 -5
  578. data/references/content-schema.md +54 -30
  579. data/references/fifth-species-counterpoint.md +29 -31
  580. data/references/fourth-species-counterpoint.md +21 -21
  581. data/references/wemi.md +1 -1
  582. data/user-stories/backlog/sixteenth-century-style.md +87 -0
  583. data/user-stories/done/abc-voices-and-meter-changes.md +274 -0
  584. data/user-stories/done/articulations-ornaments-dynamics.md +386 -0
  585. data/user-stories/done/bar-markings.md +296 -0
  586. data/user-stories/done/embellish-fifth-species-suspensions.md +473 -0
  587. data/user-stories/done/expand-playing-techniques.md +10 -1
  588. data/user-stories/done/extract-the-harmonic-cores.md +7 -7
  589. data/user-stories/done/fifth-species-guide-improvements.md +631 -0
  590. data/user-stories/done/grade-contour-misses-by-degree.md +634 -0
  591. data/user-stories/done/grade-every-fux-fifth-species-figure.md +479 -0
  592. data/user-stories/done/hairpins.md +229 -0
  593. data/user-stories/done/humdrum-kern-import-and-export.md +508 -0
  594. data/user-stories/done/instrument-variant.md +10 -1
  595. data/user-stories/done/key-and-spelling-inference.md +480 -0
  596. data/user-stories/done/lyric-extenders.md +203 -0
  597. data/user-stories/done/markings-review-follow-ups.md +183 -0
  598. data/user-stories/done/mei-export.md +450 -0
  599. data/user-stories/done/mei-import.md +647 -0
  600. data/user-stories/done/midi-export.md +448 -0
  601. data/user-stories/done/midi-import.md +664 -0
  602. data/user-stories/done/musicxml-import.md +613 -0
  603. data/user-stories/done/place-dynamics-where-no-note-starts.md +145 -0
  604. data/user-stories/done/require-the-species-rhythm.md +546 -0
  605. data/user-stories/done/rhythmic-duration.md +220 -0
  606. data/user-stories/done/spans-across-notes.md +283 -0
  607. data/user-stories/done/superclass-for-note.md +11 -0
  608. data/user-stories/done/timeline-expressions.md +535 -0
  609. data/user-stories/done/tuplets-and-grace-notes.md +549 -0
  610. data/user-stories/epics/organizing-content.md +1 -1
  611. data/user-stories/index.html +334 -246
  612. metadata +434 -16
  613. data/lib/head_music/content/flow/v3_hash_deserializer.rb +0 -52
  614. data/lib/head_music/content/placement.rb +0 -171
  615. data/lib/head_music/notation/music_xml/xml_text.rb +0 -21
  616. data/lib/head_music/notation/placement_validation.rb +0 -19
  617. data/lib/head_music/style/guidelines/mixed_rhythmic_values.rb +0 -19
  618. data/user-stories/backlog/tell-the-species-apart.md +0 -136
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: eadecb642354dfc4c70cf00303a0c1c27513fdd38b13d8bc81fe9c8e7fd3214b
4
- data.tar.gz: b534a1e194b0bd6ba4dae42433e92091812e434ec0fddb03c7617e47147207ab
3
+ metadata.gz: 157433aaffa6dc30444fe1d12511bbf3dbc1877a8384a19fb82b30b99037174d
4
+ data.tar.gz: 3168adc5bd7500b9b4e07e3b10f718e421ec5ff2419cb647e814ffe6e41d1561
5
5
  SHA512:
6
- metadata.gz: aa22ebc311f8ebe62590e99f90f0d65d639b250626f9668520cd604e0f2fec4c1ea7af4d9b944a19585c52ea1b941906f12d2910888e0a4005a7f582936547ec
7
- data.tar.gz: fde9ba8d894229bc349c861b24a0e56108f2a718526b67465c7b8631c9401a8d243196d4f632d1ebce890726c718b4371d2110fcc4e80eef39747d7ec1e610a1
6
+ metadata.gz: 63e33e764528684fdff03cd3473653f64c61d136eebff7a30fe408cceabb190e13594e96d55a33e991757547ce0ab4955c1b64bc24f2b6e02407009cdac57d82
7
+ data.tar.gz: 42e936c6dc431e27ebd16a6af38bc4fc1545a599bdd84bfa3c01ac204cb7b1bbedbe639f370f93a0abf1ef33d77a5bf95c9a1f3468aa5df7a812d77ce9fa303b
@@ -48,8 +48,28 @@ convention so far:
48
48
  sentence naming the bump and what a consumer must do to upgrade.
49
49
  - Set `VERSION` in `lib/head_music/version.rb`.
50
50
  - Run `bundle install` so `Gemfile.lock` records the new version.
51
+ - Bump the fixtures that record the gem's version. The MEI goldens write it
52
+ as `<application version="X.Y.Z">` and the MusicXML renders as
53
+ `<software>head_music X.Y.Z</software>`, and specs compare them to a fresh
54
+ render, so a bump left there fails the suite here and in the release
55
+ workflow after the tag is pushed. Find them with
56
+ `grep -rlF 'OLD.VERSION' spec/fixtures` and replace only the head_music
57
+ version in those two forms:
58
+
59
+ ```bash
60
+ grep -rlF 'OLD.VERSION' spec/fixtures | xargs sed -i '' \
61
+ -e 's/<application version="OLD\.VERSION">/<application version="X.Y.Z">/' \
62
+ -e 's/head_music OLD\.VERSION/head_music X.Y.Z/'
63
+ ```
64
+
65
+ Do not run `rake music_xml:musescore_fixtures` for this: it reconverts
66
+ every fixture through MuseScore and churns far more than the version.
67
+ Check that every changed fixture line is a version line, and that the
68
+ grep now finds nothing. A match left over is a new format embedding the
69
+ version; bump it the same way and add its form here.
51
70
  - Run `bundle exec rake` and `bundle exec rubocop` again.
52
- - Show the user the diff: CHANGELOG, version file, lockfile, nothing else.
71
+ - Show the user the diff: CHANGELOG, version file, lockfile, and the
72
+ fixtures' version lines, nothing else.
53
73
 
54
74
  ## 4. Commit and push
55
75
 
@@ -82,9 +102,10 @@ rubygems.org/gems/head_music/trusted_publishers, with repository
82
102
 
83
103
  - `gh run watch` on the run that the tag started, or
84
104
  `gh run list --workflow=release.yml --limit 1`. Report its status. Do not
85
- assume it passed. The workflow failed on every run before 2026-09-10, first
86
- on a denied API key and then on an action version that did not exist.
87
- - `gem search -r head_music` lists the new version.
105
+ assume it passed.
106
+ - `curl -s https://rubygems.org/api/v1/versions/head_music/latest.json`
107
+ reports the new version. `gem search -r` lags behind the API by minutes,
108
+ so do not read a stale result there as a failed publish.
88
109
  - `gh release view vX.Y.Z` shows the GitHub Release with the gem attached.
89
110
 
90
111
  If the workflow fails after the tag is pushed, the fallback is
@@ -57,6 +57,8 @@ jobs:
57
57
  bundle install
58
58
 
59
59
  - name: Run tests
60
+ env:
61
+ COVERAGE: ${{ matrix.coverage && 'true' || '' }}
60
62
  run: bundle exec rspec
61
63
 
62
64
  - name: Upload coverage to Codecov
@@ -99,8 +101,8 @@ jobs:
99
101
 
100
102
  # The LilyPond specs treat the real binary as an oracle and skip when none is
101
103
  # installed, so without this job nothing proves the rendered documents
102
- # actually compile. Runs the whole suite because SimpleCov's minimum applies
103
- # to any rspec invocation.
104
+ # actually compile. Only the specs that call the binary run here; the test
105
+ # job covers the rest.
104
106
  test-lilypond:
105
107
  name: test (with the lilypond toolchain)
106
108
  runs-on: ubuntu-latest
@@ -121,7 +123,44 @@ jobs:
121
123
  bundler-cache: true
122
124
 
123
125
  - name: Run tests
124
- run: bundle exec rspec
126
+ run: bundle exec rspec spec/head_music/notation/lily_pond_round_trip_spec.rb spec/head_music/notation/lily_pond
127
+
128
+ # The schema specs skip unless a local schema is named, and the schemas are
129
+ # not committed, so without this job nothing proves the MEI and MusicXML
130
+ # documents are valid. Both are pinned; the MusicXML imports are pointed at
131
+ # their local copies because the specs validate with --nonet.
132
+ test-schemas:
133
+ name: test (against the MEI and MusicXML schemas)
134
+ runs-on: ubuntu-latest
135
+ timeout-minutes: 10
136
+ env:
137
+ MEI_SCHEMA: ${{ github.workspace }}/schemas/mei-CMN.rng
138
+ MUSICXML_XSD: ${{ github.workspace }}/schemas/musicxml.xsd
139
+ steps:
140
+ - uses: actions/checkout@v7
141
+
142
+ - name: Install xmllint
143
+ run: |
144
+ sudo apt-get update
145
+ sudo apt-get install -y libxml2-utils
146
+
147
+ - name: Fetch the schemas
148
+ run: |
149
+ mkdir -p schemas
150
+ curl -sSfL -o schemas/mei-CMN.rng https://raw.githubusercontent.com/music-encoding/schema/bb4fed011f52088f8c2b9bdd4ff9674e75469aa4/5.1/mei-CMN.rng
151
+ for file in musicxml.xsd xlink.xsd xml.xsd; do
152
+ curl -sSfL -o "schemas/$file" "https://raw.githubusercontent.com/w3c/musicxml/799e2defb2ece0ae7bafe08dcbcac25b2c631d53/schema/$file"
153
+ done
154
+ sed -i 's#http://www.musicxml.org/xsd/##' schemas/musicxml.xsd
155
+
156
+ - name: Set up Ruby
157
+ uses: ruby/setup-ruby@v1
158
+ with:
159
+ ruby-version: .ruby-version
160
+ bundler-cache: true
161
+
162
+ - name: Run tests
163
+ run: bundle exec rspec spec/head_music/notation/mei_schema_spec.rb spec/head_music/notation/music_xml_schema_spec.rb
125
164
 
126
165
  lint:
127
166
  runs-on: ubuntu-latest
data/.gitignore CHANGED
@@ -26,3 +26,4 @@
26
26
 
27
27
  # Claude settings
28
28
  **/.claude/settings.local.json
29
+ .claude/agent-memory/
data/.ruby-version CHANGED
@@ -1 +1 @@
1
- 3.3.0
1
+ 3.3.11
data/.rubycritic.yml ADDED
@@ -0,0 +1,7 @@
1
+ paths:
2
+ - lib
3
+ formats:
4
+ - html
5
+ - json
6
+ minimum_score: 83
7
+ no_browser: true