Align README with product page v2

Author: Zer0pa-Architect-Prime

.github/assets/readme/lane-mechanics/MUSIC.gif

@@ -8,41 +8,66 @@
 
 ## What This Is
 
-`zpe-music` is a music encoding product for canonical symbolic score data, with a bounded note-local expression refinement carried on the same score note. It targets MusicXML pipelines that need auditable roundtrip recovery of score structure plus note-local `attack`, `release`, and `dynamics`-derived fields.
+Canonical symbolic-score codec. MusicXML score structure plus note-local attack, release, and dynamics-derived fields round-trip under the declared proof surface.
 
 It does not do audio understanding. The public surface is canonical symbolic score plus a bounded note-local expression refinement, and the hard boundaries are stated explicitly below.
 
+## Codec Mechanics
+
+<p>
+  <img src=".github/assets/readme/lane-mechanics/MUSIC.gif" alt="ZPE-Music Codec Mechanics animation" width="100%">
+</p>
+
 | Field | Value |
-|-------|-------|
+| ------- | ------- |
 | Architecture | MUSIC_STREAM |
 | Encoding | MUSIC_SYMBOLIC_V1 |
+| Mechanics Asset | `.github/assets/readme/lane-mechanics/MUSIC.gif` |
 
 ## Key Metrics
 
 | Metric | Value | Baseline |
-|--------|-------|----------|
-| SCORE_EVENT_EXACT (`score_event_exact_rate_mean`) | 1.0 | — |
-| PART_EXACT (`part_exact_rate_mean`) | 1.0 | — |
-| ARTICULATION_EXACT (`articulation_exact_rate_mean`) | 1.0 | — |
-| EXPRESSION_EVENT_EXACT (`expression_event_exact_rate_mean`) | 1.0 | — |
+| -------- | ------- | ---------- |
+| SCORE_EVENT_EXACT (score_event_exact_rate_mean) | 1.0 | — |
+| PART_EXACT (part_exact_rate_mean) | 1.0 | — |
+| ARTICULATION_EXACT (articulation_exact_rate_mean) | 1.0 | — |
+| EXPRESSION_EVENT_EXACT (expression_event_exact_rate_mean) | 1.0 | — |
 
 > Source: `proofs/artifacts/music_release_metrics.json`, `validation/results/release_verification.json`
 
-All four metrics measured on the bounded authority test corpus (11 synthetic/controlled MusicXML cases). These are test-corpus results on the authority path, not production-generality claims. This is a symbolic-score codec — no audio codec comp benchmarks (MP3/AAC/Opus/MIDI/MusicGen) exist or apply.
+## Repo Identity
 
-Additional verified metrics (not in the 4-row canonical table, included for full disclosure):
+| Field | Value |
+| ------- | ------- |
+| Identifier | ZPE-Music |
+| Repository | https://github.com/Zer0pa/ZPE-Music |
+| Section | encoding |
+| Visibility | PUBLIC |
+| Architecture | MUSIC_STREAM |
+| Encoding | MUSIC_SYMBOLIC_V1 |
+| Commit SHA | cdd6b75 |
+| License | SAL-7.0 |
+| Authority Source | proofs/artifacts/music_release_metrics.json |
 
-| Metric | Value | Proof artifact | CI test |
-|--------|-------|----------------|---------|
-| PERFORMANCE_TUPLE_EXACT (`performance_tuple_exact_rate_mean`) | 1.0 | `proofs/artifacts/music_release_metrics.json` | `tests/test_music_expression_authority_roundtrip.py` |
-| REPEATED_NOTE_CASE (`repeated_note_case_exact_rate`) | 1.0 | `proofs/artifacts/music_release_metrics.json` | `tests/test_music_expression_authority_roundtrip.py::test_repeated_note_expression_roundtrip_exact` |
-| REQUIRED_CHECKS_PASSED | 11/11 in 3.39 s | `validation/results/release_verification.json` | `validation/run_release_verification.py` |
+## Readiness
+
+| Field | Value |
+| ------- | ------- |
+| Verdict | STAGED |
+| Checks | 7/7 |
+| Anchors | 2 display anchors |
+| Commit | cdd6b75 |
+| Authority | proofs/artifacts/music_release_metrics.json |
+
+### Honest Blocker
+
+Audio waveform understanding or performer-audio interpretation.; Continuous tempo curves or continuous dynamics curves.; Pedal, sustain, performer state, or general expressive performance modeling.
 
 ## What We Prove
 
 - Canonical symbolic score events roundtrip exactly on the verified authority path.
 - Part, voice, rest, articulation, and per-event program survive the bounded score surface exactly.
-- Note-local expression fields derived from MusicXML `attack`, `release`, and `dynamics` roundtrip exactly on the same score-anchored note object.
+- Note-local expression fields derived from MusicXML attack, release, and dynamics roundtrip exactly on the same score-anchored note object.
 - Repeated same-pitch notes remain distinguishable on the bounded expression cases.
 
 ## What We Don't Claim
@@ -51,43 +76,50 @@ Additional verified metrics (not in the 4-row canonical table, included for full
 - Continuous tempo curves or continuous dynamics curves.
 - Pedal, sustain, performer state, or general expressive performance modeling.
 - Raw MusicXML part-name identity recovery.
-- Anything beyond bounded note-local `attack`, `release`, and `dynamics`-derived refinement.
+- Anything beyond bounded note-local attack, release, and dynamics-derived refinement.
 - MP3/AAC/Opus/MIDI/MusicGen baselines — this is a symbolic codec; no audio codec comparisons exist or apply.
 
-## Commercial Readiness
-
-| Field | Value |
-|-------|-------|
-| Verdict | STAGED |
-| Commit SHA | cdd6b75 |
-| Source | `proofs/artifacts/music_release_metrics.json` |
-
-## Tests and Verification
+## Verification Status
 
 | Code | Check | Verdict |
-|------|-------|---------|
-| V_01 | Score event exact roundtrip — `tests/test_music_authority_roundtrip.py` | PASS |
-| V_02 | Part, voice, rest, articulation, program exact roundtrip — `tests/test_music_authority_roundtrip.py` | PASS |
-| V_03 | Expression event exact roundtrip — `tests/test_music_expression_authority_roundtrip.py` | PASS |
-| V_04 | Performance tuple exact roundtrip — `tests/test_music_expression_authority_roundtrip.py` | PASS |
-| V_05 | Repeated same-pitch note distinguishability — `tests/test_music_expression_authority_roundtrip.py::test_repeated_note_expression_roundtrip_exact` | PASS |
-| V_06 | Guardrail battery (out-of-scope rejection) — `tests/test_music_authority_guardrails.py` | PASS |
-| V_07 | Release verification suite 11/11 — `validation/run_release_verification.py` | PASS |
+| ------ | ------- | --------- |
+| V_01 | Score event exact roundtrip — tests/test_music_authority_roundtrip.py | PASS |
+| V_02 | Part, voice, rest, articulation, program exact roundtrip — tests/test_music_authority_roundtrip.py | PASS |
+| V_03 | Expression event exact roundtrip — tests/test_music_expression_authority_roundtrip.py | PASS |
+| V_04 | Performance tuple exact roundtrip — tests/test_music_expression_authority_roundtrip.py | PASS |
+| V_05 | Repeated same-pitch note distinguishability — tests/test_music_expression_authority_roundtrip.py::test_repeated_note_expression_roundtrip_exact | PASS |
+| V_06 | Guardrail battery (out-of-scope rejection) — tests/test_music_authority_guardrails.py | PASS |
+| V_07 | Release verification suite 11/11 — validation/run_release_verification.py | PASS |
 
 ## Proof Anchors
 
 | Path | State |
-|------|-------|
+| ------ | ------- |
 | `proofs/artifacts/music_release_metrics.json` | VERIFIED |
 | `validation/results/release_verification.json` | VERIFIED |
 
 ## Repo Shape
 
 | Field | Value |
-|-------|-------|
-| Proof Anchors | 2 |
+| ------- | ------- |
+| Proof Anchors | 2 display anchors |
 | Modality Lanes | 1 |
-| Authority Source | `proofs/artifacts/music_release_metrics.json` |
+| Architecture | MUSIC_STREAM |
+| Encoding | MUSIC_SYMBOLIC_V1 |
+| Verification | 7/7 checks |
+| Authority Source | proofs/artifacts/music_release_metrics.json |
+
+## Extended Metrics
+
+Detailed metric rows retained from the previous `## Key Metrics` section. The public product page uses the four-row summary above.
+
+Additional verified metrics (not in the 4-row canonical table, included for full disclosure):
+
+| Metric | Value | Proof artifact | CI test |
+|--------|-------|----------------|---------|
+| PERFORMANCE_TUPLE_EXACT (`performance_tuple_exact_rate_mean`) | 1.0 | `proofs/artifacts/music_release_metrics.json` | `tests/test_music_expression_authority_roundtrip.py` |
+| REPEATED_NOTE_CASE (`repeated_note_case_exact_rate`) | 1.0 | `proofs/artifacts/music_release_metrics.json` | `tests/test_music_expression_authority_roundtrip.py::test_repeated_note_expression_roundtrip_exact` |
+| REQUIRED_CHECKS_PASSED | 11/11 in 3.39 s | `validation/results/release_verification.json` | `validation/run_release_verification.py` |
 
 ## Quick Start