head_music 8.3.0 → 9.0.1

data/user_stories/todo/organizing-content.md

@@ -0,0 +1,72 @@
+
+Project = overall container.
+Flow = segment-level unit (supports sketches, movements, cues).
+Sequence = neutral term for the editing canvas (2D space).
+Timeline = strictly the axis.
+
+
+Material?
+
+ScorePart
+@name
+>> instruments
+def primary_instrument
+def default_staff_system
+
+
+MusicContent
+>> score_parts
+@score_type (orchestral, band, chamber, pop, solo)
+def ordered_score_parts
+def score_parts_grouped_by_orchestra_section
+  # so we can square-bracket the sections
+
+
+
+Score < MusicContent
+@title
+@subtitle
+@dedication
+>> score_credits
+
+
+ScoreCredit
+> person
+- role (composer, songwriter, lyricist, arranger, transcriber)
+
+
+Person
+- full_name
+- birth_year int optional
+- death_year int optional
+
+
+ScoreLayout < Layout
+
+
+
+EnsembleSession (rehearsal, recording, or performance)
+>> scores
+>> score_part_players
+
+
+ScorePartPlayer
+> score_part
+>> players
+
+
+
+
+Player
+> person
+
+
+
+Fragment < MusicContent
+
+
+
+
+
+
+

data/user_stories/todo/percussion_set.md

@@ -0,0 +1 @@
+Create a PercussionSet staff for percussion or drum kit parts in a score.

data/user_stories/{backlog → todo}/pitch-class-set-analysis.md

@@ -6,6 +6,46 @@ I want to analyze pitch class sets
 
 So that I can identify set relationships and transformations
 
+## Scenario: Get size of pitch class set
+
+Given I have a pitch class set
+
+When I call the size method
+
+Then it should return the number of unique pitch classes
+
+## Scenario: Check if monad
+
+Given I have a pitch class set with one pitch class
+
+When I call monad?
+
+Then it should return true
+
+## Scenario: Check if dyad
+
+Given I have a pitch class set with two pitch classes
+
+When I call dyad?
+
+Then it should return true
+
+## Scenario: Check if triad
+
+Given I have a pitch class set with three pitch classes
+
+When I call triad?
+
+Then it should return true only if they form stacked thirds
+
+## Scenario: Check if trichord
+
+Given I have a pitch class set with three pitch classes
+
+When I call trichord?
+
+Then it should return true for any 3-pitch class set
+
 ## Scenario: Find normal form
 
 Given I have a pitch class set

data/user_stories/{backlog → todo}/pitch-set-classification.md

@@ -6,6 +6,16 @@ I want to classify pitch sets by their size and properties
 
 So that I can analyze and categorize harmonic structures
 
+Note: A PitchSet is unlike a PitchClassSet in that the pitches have spellings with octaves rather than Spellings only or octave-less 0-11 designations.
+
+## Scenario: Get size of pitch set
+
+Given I have a pitch set with N pitches
+
+When I call the size method
+
+Then it should return the number of pitches in the set
+
 ## Scenario: Identify empty set
 
 Given I have no pitches

data/user_stories/{backlog → todo}/sonority-identification.md

@@ -45,3 +45,23 @@ When I call the sonority method
 Then I should receive the corresponding Sonority object
 
 And it should correctly identify the harmonic content
+
+## Scenario: Work with triads
+
+Given I need to analyze triadic harmony
+
+When I work with Triad objects
+
+Then I should be able to identify major, minor, diminished, and augmented triads
+
+And access their specific properties and methods
+
+## Scenario: Work with seventh chords
+
+Given I need to analyze seventh chord harmony
+
+When I work with SeventhChord objects
+
+Then I should be able to identify all common seventh chord types
+
+And note that nothing beyond seventh chords is needed to analyze pre-Romantic music

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: head_music
 version: !ruby/object:Gem::Version
-  version: 8.3.0
+  version: 9.0.1
 platform: ruby
 authors:
 - Rob Head
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-26 00:00:00.000000000 Z
+date: 2025-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -150,9 +150,9 @@ files:
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
+- MUSIC_THEORY.md
 - README.md
 - Rakefile
-- TODO.md
 - bin/check_instrument_consistency.rb
 - bin/console
 - bin/setup
@@ -167,6 +167,7 @@ files:
 - lib/head_music/analysis/diatonic_interval/semitones.rb
 - lib/head_music/analysis/diatonic_interval/size.rb
 - lib/head_music/analysis/harmonic_interval.rb
+- lib/head_music/analysis/interval_consonance.rb
 - lib/head_music/analysis/interval_cycle.rb
 - lib/head_music/analysis/melodic_interval.rb
 - lib/head_music/analysis/motion.rb
@@ -178,13 +179,15 @@ files:
 - lib/head_music/content/note.rb
 - lib/head_music/content/placement.rb
 - lib/head_music/content/position.rb
-- lib/head_music/content/rhythmic_value.rb
 - lib/head_music/content/staff.rb
 - lib/head_music/content/voice.rb
 - lib/head_music/instruments/instrument.rb
 - lib/head_music/instruments/instrument_families.yml
 - lib/head_music/instruments/instrument_family.rb
+- lib/head_music/instruments/instrument_type.rb
 - lib/head_music/instruments/instruments.yml
+- lib/head_music/instruments/score_order.rb
+- lib/head_music/instruments/score_orders.yml
 - lib/head_music/instruments/staff.rb
 - lib/head_music/instruments/staff_scheme.rb
 - lib/head_music/instruments/variant.rb
@@ -197,34 +200,49 @@ files:
 - lib/head_music/locales/ru.yml
 - lib/head_music/named.rb
 - lib/head_music/rudiment/alteration.rb
+- lib/head_music/rudiment/base.rb
 - lib/head_music/rudiment/chromatic_interval.rb
 - lib/head_music/rudiment/clef.rb
 - lib/head_music/rudiment/clefs.yml
 - lib/head_music/rudiment/consonance.rb
+- lib/head_music/rudiment/diatonic_context.rb
+- lib/head_music/rudiment/key.rb
 - lib/head_music/rudiment/key_signature.rb
 - lib/head_music/rudiment/key_signature/enharmonic_equivalence.rb
 - lib/head_music/rudiment/letter_name.rb
 - lib/head_music/rudiment/meter.rb
+- lib/head_music/rudiment/mode.rb
 - lib/head_music/rudiment/musical_symbol.rb
+- lib/head_music/rudiment/note.rb
 - lib/head_music/rudiment/pitch.rb
 - lib/head_music/rudiment/pitch/enharmonic_equivalence.rb
 - lib/head_music/rudiment/pitch/octave_equivalence.rb
+- lib/head_music/rudiment/pitch/parser.rb
 - lib/head_music/rudiment/pitch_class.rb
 - lib/head_music/rudiment/quality.rb
 - lib/head_music/rudiment/reference_pitch.rb
 - lib/head_music/rudiment/register.rb
+- lib/head_music/rudiment/rest.rb
 - lib/head_music/rudiment/rhythm.rb
+- lib/head_music/rudiment/rhythmic_element.rb
 - lib/head_music/rudiment/rhythmic_unit.rb
+- lib/head_music/rudiment/rhythmic_unit/parser.rb
+- lib/head_music/rudiment/rhythmic_units.yml
+- lib/head_music/rudiment/rhythmic_value.rb
+- lib/head_music/rudiment/rhythmic_value/parser.rb
 - lib/head_music/rudiment/scale.rb
 - lib/head_music/rudiment/scale_degree.rb
 - lib/head_music/rudiment/scale_type.rb
 - lib/head_music/rudiment/solmization.rb
 - lib/head_music/rudiment/solmizations.yml
 - lib/head_music/rudiment/spelling.rb
+- lib/head_music/rudiment/tempo.rb
+- lib/head_music/rudiment/tonal_context.rb
 - lib/head_music/rudiment/tuning.rb
 - lib/head_music/rudiment/tuning/just_intonation.rb
 - lib/head_music/rudiment/tuning/meantone.rb
 - lib/head_music/rudiment/tuning/pythagorean.rb
+- lib/head_music/rudiment/unpitched_note.rb
 - lib/head_music/style/analysis.rb
 - lib/head_music/style/annotation.rb
 - lib/head_music/style/guidelines/always_move.rb
@@ -265,17 +283,30 @@ files:
 - lib/head_music/style/guides/fux_cantus_firmus.rb
 - lib/head_music/style/guides/modern_cantus_firmus.rb
 - lib/head_music/style/mark.rb
+- lib/head_music/style/medieval_tradition.rb
+- lib/head_music/style/modern_tradition.rb
+- lib/head_music/style/renaissance_tradition.rb
+- lib/head_music/style/tradition.rb
 - lib/head_music/utilities/hash_key.rb
 - lib/head_music/version.rb
 - test_translations.rb
-- user_stories/backlog/band-score-order.md
-- user_stories/backlog/chamber-ensemble-score-order.md
-- user_stories/backlog/consonance-dissonance-classification.md
-- user_stories/backlog/dyad-analysis.md
-- user_stories/backlog/orchestral-score-order.md
-- user_stories/backlog/pitch-class-set-analysis.md
-- user_stories/backlog/pitch-set-classification.md
-- user_stories/backlog/sonority-identification.md
+- user_stories/active/handle-time.md
+- user_stories/active/handle-time.rb
+- user_stories/done/epic--score-order/PLAN.md
+- user_stories/done/epic--score-order/band-score-order.md
+- user_stories/done/epic--score-order/chamber-ensemble-score-order.md
+- user_stories/done/epic--score-order/orchestral-score-order.md
+- user_stories/done/instrument-variant.md
+- user_stories/done/superclass-for-note.md
+- user_stories/todo/agentic-daw.md
+- user_stories/todo/consonance-dissonance-classification.md
+- user_stories/todo/dyad-analysis.md
+- user_stories/todo/material-and-scores.md
+- user_stories/todo/organizing-content.md
+- user_stories/todo/percussion_set.md
+- user_stories/todo/pitch-class-set-analysis.md
+- user_stories/todo/pitch-set-classification.md
+- user_stories/todo/sonority-identification.md
 homepage: https://github.com/roberthead/head_music
 licenses:
 - MIT

data/TODO.md

@@ -1,109 +0,0 @@
-# TODO
-
-## User Stories
-
-Sets
-DurationSet?
-
-Triad
-SeventhChord
-Don't need anything beyond seventh chords to analyze pre-Romantic music.
-
-
-## User stories
-
-
-### Done
-
-    As a developer
-    When instantiating a DiatonicInterval
-    When passing an abbreviation, such as 'P5' or 'm2'
-    I want to receive that instance.
-
-    As a developer
-    Given a pitch
-    I want to be able to add a diatonic interval to get another pitch.
-
-DiatonicInterval
-  - def above(pitch) -> pitch
-DiatonicInterval
-  - def below(pitch) -> pitch
-
-Pitch addition and subtraction
-  - define `Pitch#+`, `Pitch#-`
-  - use DiatonicInterval methods
-
-PitchSet
-
-A PitchSet is unlike a PitchClassSet in that the pitches have spellings with octaves rather than Spellings only or octave-less 0-11 designations.
-
-PitchClassSet
-.size?
-.monad?
-.dyad?
-.triad? (must be stacked thirds to be a 'triad')
-.trichord? (all 3-pitch sets)
-
-Should every group of pitches have one or more strategies for describing it? Such as Dyad?
-
-Set (superclass?)
-PitchSet
-  EmptySet
-  Monad
-  Dyad
-  Trichord (or Triad)
-    - triad?
-  Tetrachord (or Tetrad)
-    - seventh_chord?
-  Pentachord (or Pentad)
-  Hexachord (or Hexad)
-  Heptachords (or Heptad or, sometimes, mixing Latin and Greek roots, "Septachord")
-  Octachords (Octad)
-  Nonachords (Nonad)
-  Decachords (Decad)
-  Undecachords
-  Dodecachord
-
-PitchClassSet
-  .normal_form? (most compact)
-  .prime_form (most compact normal form of the original or any inversion)
-
-
-## Text Conversation with Brian Head (May 7, 2023)
-
-Brian Head, brother and faculty at USC Thornton School of Music
-https://music.usc.edu/brian-head/
-
-Robert Head:
-	Hey, Brian. You have a sec for a music question? I’m trying to come up with different terms for the way “family” is used. “Woodwind family” vs. “Oboe family”.
-
-Brian Head:
-	Those are good, I’d say.  In what context?
-
-Robert Head:
-	In my software project, I’m trying to define those relationships. One is a section of the orchestra and the other is species of instrument. But usually people, in my experience, just say “family”.
-	Is there some more precise terminology or adjective that can disambiguate those two terms?
-
-Brian Head:
-	Hmmm. Already “family” is informal. Blatter distinguishes between “choir” and “family” as in the  trumpet family” within the “brass choir”.
-
-Robert Head:
-	Ah, yes! I do like that.
-	But does it apply to percussion?
-	“Section” is another candidate, but that gets used for string parts as well.
-
-Brian Head:
-	Strings and percussion probably don’t think of themselves as a choir, but if you’re mainly looking for a taxonomically consistent word, that’s the feat I can think of at the moment.
-	Section is a good word, too, which easily flows between smaller and larger meanings.
-
-Robert Head:
-	Obviously, the four “families” is a garbage way to classify all instruments and it really is more applicable to the orchestral context, so maybe “orchestra family” or “orchestra section”.
-
-Brian Head:
-	I’d say that “family” is best used at the instrument level, as in “saxophone family”. Choir or section are better for larger collections. Still, both of those words connote membership in an orchestra. Or large ensemble.  “Woodwinds” or “percussion” describe the class of instruments themselves.
-
-Robert Head:
-	Cool
-
-Action Item: Call them orchestra_section
-DONE