zpe-music

6/6 exact roundtrip metrics. 11/11 checks passing. Bounded symbolic-score codec with note-local expression refinement. No audio waveforms. No comp benchmarks.

zpe-music is part of the Zer0pa portfolio of encoding products — one of 17 independent domain codecs, each with its own proof surface.

What This Is

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

Key Metrics

Source: proofs/artifacts/music_release_metrics.json, validation/results/release_verification.json

Repo Identity

Readiness

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.
• Repeated same-pitch notes remain distinguishable on the bounded expression cases.

What We Don't Claim

• Audio waveform understanding or performer-audio interpretation.
• 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.
• MP3/AAC/Opus/MIDI/MusicGen baselines — this is a symbolic codec; no audio codec comparisons exist or apply.

Verification Status

Proof Anchors

Repo Shape

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):

Quick Start

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e '.[dev]'
python validation/run_release_verification.py
python -m pytest -q tests/test_music_authority_roundtrip.py tests/test_music_expression_authority_roundtrip.py tests/test_music_authority_guardrails.py

Upcoming Workstreams

This section captures the active lane priorities — what the next agent or contributor picks up, and what investors should expect. Cadence is continuous, not milestoned.

• Real MusicXML corpus benchmark — Active Engineering. Benchmark against MuseScore open scores (~50) and IMSLP MusicXML exports (~50) to validate the authority path beyond the 11 synthetic cases.