docs: refresh README for the portrait build (cat, music, flipper notes)

README.md

@@ -52,7 +52,7 @@ python3 -m venv .venv
   inside 2.5s builds your **combo multiplier** (up to ×9).
 - Watch the bottom-centre drain and the two outlanes… or lose the ball.
 - Every **50,000 points** earns an extra ball.
-- Squirrel says encouraging things. Blush at the cat in the corner.
+- The kawaii cat helper reacts to your shots from the corner.
 
 ## Project layout
 
@@ -76,6 +76,9 @@ Dev / test tools (run headless, no window needed):
 
 ## Design notes
 
+- **Portrait table**: a `360×480` playfield like a real pinball machine,
+  with regular-sized flippers (about a quarter of the playfield width each)
+  at the bottom and a wide centre drain between them.
 - **Physics**: fixed 60 Hz logic with up to 6 collision substeps so the ball
   never tunnels; kinematic flippers whose angular velocity is transferred to
   the ball (real "scoop" feel); inward-tilting floor funnels; centre drain +
@@ -83,8 +86,9 @@ Dev / test tools (run headless, no window needed):
 - **Fun tuning was data-driven**: an `autotest.py` bot plays thousands of
   frames and reports hit/drain rates per table element, so bumper, slingshot
   and flipper geometry was tuned against measured behaviour, not guesswork.
-- **Audio**: square/triangle/noise oscillators -> PCM at startup; distinct
+- **Audio**: soft triangle/sine voices -> PCM at startup; pitched bumper pops
-  pitched bump sounds that climb with your combo, plus two generative music
+  that climb with your combo, plus two real melodies (a slow *Twinkle Twinkle*
-  loops (menu + play).
+  lullaby on the title, a bouncier version during play — no square-wave or
+  noise percussion in the music).
 
 Licence: MIT — go wild.