Skip to content

docs(plan): score engraving and polyphony roadmap - #4

Open
akshayswaroop wants to merge 1 commit into
mainfrom
plan/score-engraving-and-polyphony-roadmap
Open

akshayswaroop wants to merge 1 commit into
mainfrom
plan/score-engraving-and-polyphony-roadmap

Conversation

@akshayswaroop

@akshayswaroop akshayswaroop commented Aug 13, 2026

Copy link
Copy Markdown
Owner

Summary

Documentation-only roadmap for improving ExactKeys piano engraving while preserving the repository's fail-closed accuracy contract.

This PR contains no runtime implementation and changes no certification behavior.

Planned areas

  • Support independent same-staff voices using an explicit score voice model and valid MusicXML <backup> / <forward> timelines.
  • Preserve the existing exact-onset/equal-duration chord behavior while extending only polyphony that can round-trip without dropped or altered events.
  • Investigate rolling key-change detection; all proposed window and confidence values are hypotheses requiring fixture-backed validation.
  • Add beat-group-aware duration spelling while preserving exact tied-note recovery.
  • Require production-path adversarial tests and 100% MusicXML reparse fidelity for every future certifying change.

Contract boundaries

  • score-note-v1 remains MIDI-relative and fail-closed.
  • Audio-derived notes remain permanently uncertified under the current contract.
  • Voice allocation and inferred key changes are notation decisions, not unqualified accuracy claims.
  • Unsupported polyphony continues to abstain until exact representation is proven.

Scope

Exactly one file:

  • docs/plans/2026-08-13-score-engraving-and-polyphony-roadmap.md

Verification

@akshayswaroop
akshayswaroop force-pushed the plan/score-engraving-and-polyphony-roadmap branch from 65e6c08 to 68b63b9 Compare August 13, 2026 15:32
@akshayswaroop akshayswaroop changed the title docs(plan): score engraving, chord clustering, and dynamic key modulation roadmap docs(plan): score engraving and polyphony roadmap Aug 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant