Deterministic prosody encoding for F0 contours and rhythm patterns where replay must stay stable across runs, platforms, and library versions. The lane remains FAIL: compression and fidelity are real, but retrieval closure missed badly enough that the commercial wedge is still blocked.
ZPE-Prosody is aimed at speech-technology and voice-analytics infrastructure teams that care about reproducible prosodic features, not generic audio compression. The current authority packet proves a narrow, auditable codec surface. It does not prove release readiness, commercialization-safe transfer, or retrieval performance strong enough to carry the lane.
| Field | Value |
|---|---|
| Architecture | PROSODIC_CONTOUR |
| Encoding | F0_DELTA_V1 |
| Metric | Value | Baseline |
|---|---|---|
| COMPRESSION | 16.60× | — |
| F0_RMSE | 0.89% | — |
| ENERGY_RMSE | 2.08% | — |
| RETRIEVAL_P@5 | 0.31 | 0.80 gate |
Source: before_after_metrics.json, prosody_compression_benchmark.json, prosody_f0_fidelity.json, prosody_energy_fidelity.json, c006_retrieval_failure_analysis.md
No promoted competitive benchmark is live on the current authority surface. The honest reading is narrower: this repo has a real prosody codec packet with real failure evidence on retrieval, so it should not be read as a speech-codec winner table.
| Comparator Surface | Current Reading | Notes |
|---|---|---|
| Head-to-head public benchmark | Not promoted | Retrieval closure failed, so no commercial-safe comparator claim survives the current packet |
- Mean compression ratio of
16.60×on the tracked Wave-1 corpus. - F0 fidelity at
0.89%mean RMSE and energy fidelity at2.08%mean RMSE on the tracked evaluation slice. - Bit-stable deterministic replay on the committed Wave-1 determinism path.
- The retrieval route was actually executed and actually failed; the lane block is performance, not missing environment setup.
- No claim of lane pass.
- No claim of retrieval closure above threshold.
- No claim of commercialization-safe transfer or public release readiness.
- No claim of human MOS validation or speech-codec comparator leadership.
- No claim that the paused external dependency path is closed.
| Field | Value |
|---|---|
| Verdict | FAIL |
| Release posture | Live work in progress; not a final official release |
| Commit SHA | 3115c5dfb737 |
| Primary Blocker | PRO-C006 retrieval closure |
| Source | proofs/artifacts/2026-02-20_zpe_prosody_wave1/quality_gate_scorecard.json, proofs/artifacts/c006_retrieval_failure_analysis.md |
The current lane is useful as a bounded proof packet for deterministic prosody encoding, but not as a released commercial wedge. The blocker is explicit and material: the retrieval method missed badly enough that redesign or descope is the honest next path.
| Code | Check | Verdict |
|---|---|---|
| V_01 | Compression benchmark | PASS |
| V_02 | F0 fidelity | PASS |
| V_03 | Energy fidelity | PASS |
| V_04 | Determinism replay | PASS |
| V_05 | Retrieval evaluation | FAIL |
| Path | State |
|---|---|
proofs/artifacts/2026-02-20_zpe_prosody_wave1/prosody_compression_benchmark.json |
VERIFIED |
proofs/artifacts/2026-02-20_zpe_prosody_wave1/prosody_f0_fidelity.json |
VERIFIED |
proofs/artifacts/2026-02-20_zpe_prosody_wave1/prosody_energy_fidelity.json |
VERIFIED |
proofs/artifacts/2026-02-20_zpe_prosody_wave1/determinism_replay_results.json |
VERIFIED |
proofs/artifacts/2026-02-20_zpe_prosody_wave1/quality_gate_scorecard.json |
VERIFIED |
proofs/artifacts/c006_retrieval_failure_analysis.md |
VERIFIED |
| Field | Value |
|---|---|
| Proof Anchors | 6 |
| Modality Lanes | 1 |
| Authority Source | proofs/artifacts/c006_retrieval_failure_analysis.md |
src/zpe_prosody/: installable codec package.tests/: repo-local regression checks.scripts/: operator scripts and packaging helpers.proofs/: Wave-1 evidence and adjudication artifacts.docs/: architecture and legal-boundary notes.
# Install from PyPI
pip install zpe-prosodyOr install from source for the repo-local verification path:
python -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
make repo-sanity
make package-sanity
make testOptional extras:
python -m pip install ".[api]"for the FastAPI/Uvicorn wrapper.python -m pip install ".[benchmarks]"for the NumPy-backed benchmark helpers.
The base wheel ships only src/zpe_prosody. scripts/ remains a repo-local operator surface, not an installed CLI contract. Read docs/LEGAL_BOUNDARIES.md before widening any claim from this repo state.
