theory: add hook-first song generator

claude.md

@@ -1,6 +1,16 @@
 # code-music — project state
 
-## Status: v170.0.0 — 415 songs, 3705 tests, 98 effects, 171 presets, 595+ theory functions
+## Status: v170.1.0 — hook-first generator PR open (#2), 415 songs, 3716+ tests, 98 effects, 171 presets, 598+ theory functions
+
+## Current Work — Hook-First Generation
+
+- Open PR: [#2](https://github.com/Talador12/code-music/pull/2) `theory: add hook-first song generator`.
+- Adds `hook_progression`, `generate_hook`, `generate_hook_song`, `concept_palette`, and `generate_concept_suite` in `code_music.theory`.
+- The generator turns circle-of-fifths / ii-V-I gravity, short repeated motifs, and genre-specific arrangement defaults into runnable hooks.
+- Styles covered in this first slice: `zedd` / EDM, `coltrane`, and `symphonic`.
+- Concept-suite layer maps album ideas (`Rasputin`, planets, constellations, Fibonacci, elements, time) to deterministic style/key/BPM palettes and produces multiple runnable sketch Songs.
+- New samples: `samples/chords/hook_circle.py` and `samples/chords/concept_suite.py`, rendered successfully to `/tmp/hook_circle.wav` and `/tmp/concept_suite.wav`.
+- Validation: targeted Ruff checks, `tests/test_hooks.py`, `tests/test_concept_suite.py`, related generator tests, examples smoke tests, and full pytest (`3804 passed, 3 skipped, 2 warnings`) passed using the existing venv.
 
 ## Current Work — Terminal Visualizer
 

code_music/theory/__init__.py

@@ -103,6 +103,7 @@
     comp_pattern,
     compare_songs,
     compose,
+    concept_palette,
     continue_in_style,
     density_plan,
     detect_tempo,
@@ -117,11 +118,14 @@
     extend_progression,
     generate_bass_line,
     generate_canon,
+    generate_concept_suite,
     generate_drums,
     generate_form,
     generate_from_matrix,
     generate_fugue,
     generate_full_song,
+    generate_hook,
+    generate_hook_song,
     generate_period,
     generate_phrase,
     generate_progression,
@@ -132,6 +136,7 @@
     grade_lesson,
     grade_quiz,
     half_time,
+    hook_progression,
     in_range,
     instrument_range,
     just_ratio,
@@ -430,6 +435,7 @@
     "complexity_curve",
     "complexity_score",
     "consonance_score",
+    "concept_palette",
     "continue_in_style",
     "contour_match",
     "contour_string",
@@ -485,6 +491,7 @@
     "functional_analysis",
     "generate_bass_line",
     "generate_canon",
+    "generate_concept_suite",
     "generate_chord_melody",
     "generate_countermelody",
     "generate_chord_voicing",
@@ -499,6 +506,9 @@
     "generate_rondo",
     "generate_sonata_form",
     "generate_theme_and_variations",
+    "hook_progression",
+    "generate_hook",
+    "generate_hook_song",
     "generate_progression",
     "generate_rhythm_pattern",
     "generate_scale_melody",