``` Step 6 report — deterministic description and coordinated Standard MIDI Date: 2026-10-19 OUTCOME: IMPLEMENTED, PERSISTENT AND VERIFIED. FINAL VALIDATION: 868 passed; 0 failed; 0 skipped. STANDARD MIDI ONLY: no verified vendor maps, native formats or application acceptance. NEXT-STEP STATUS: ready for Step 6 review; native evidence gates remain open. SCOPE Read prompts\step_6.md, the amended approved plan's continuation decision and Step 6 scope, accepted report_5_fix.md, current request/intent/score/result/error contracts, profile models/registry, compiler, exact timing helpers and writer. Implemented only the owned Step 6 surfaces: Created: - src\riff_groove_builder\description.py - src\riff_groove_builder\compose.py - tests\unit\test_description.py - tests\unit\test_compose.py - tests\integration\test_text_to_midi.py - prompts\report_6.md Updated: - README.md - docs\architecture.md No shared contract, profile/resource, compiler, MIDI writer, Step 3 handler, dependency manifest or earlier report/plan was changed by this step. No network/model service, audio, native codec, MCP wiring, later-prompt work, commit or delegation. Existing unrelated/pre-existing worktree changes remain. APIS AND RESOLUTION resolve_description(request: GenerateMusicRequest) -> DescriptionResolution returns intent: MusicalIntent, assumptions: unique list[str], overrides: unique list[str]. These records are suitable for future ResolvedGeneration, not a fabricated GenerationResult. It revalidates mutable request graphs. compose_score(intent: MusicalIntent, selected_profiles: dict[Part, InstrumentProfile], *, ppq=960) -> Score revalidates intent/profiles. Call the authoritative registry's select(intent.parts, request.profiles or ProfileSelection()), compose, compile_score, then write_midi. Nondefault PPQ must also be passed to compile_score. No parser/composer filesystem IO occurs. Structured non-null tempo/bars/meter/key/parts win over text, even contradictory or out-of-bounds scalar candidates for that field. Every structured value is disclosed with its text candidates, including when none were present. Null remains unresolved. Unknown material/changing instructions cannot be authorized by these overrides. Equivalent repeated values and enharmonic keys are not contradictions; distinct unresolved candidates are actionable errors. Textual part order is lead,bass,drums; structured order is preserved. EXACT SUPPORTED GRAMMAR AND DEFAULTS This is a closed grammar, not free-form language or a general genre engine. Case is folded, whitespace collapsed, whole words matched. Clauses may appear in any order. The following are global instructions, not per-part schedules: - Numeric BPM: signed decimal number followed by BPM, optional whitespace, final 20-300 quarter-note beats/minute. Example: 137.5 BPM. No fractional notation, exponent, textual numbers, beat-unit conversion or tempo changes. - Bars: signed numeric value followed by bar/bars; integer-valued 1-256. 4.0 bars is accepted as four; 1.5 bars is not. - Meter: n/d, optional spaces around slash; optional in/meter filler. Numerator 1-16; denominator 1,2,4,8,16. No changing or mixed meters. - Key: A-G, optional one ASCII #/b, major/minor. Natural minor only. Existing canonical sharp spelling is retained: Bb major -> A# major. - Lead aliases: lead, lead guitar, guitar, riff. - Bass aliases: bass, bass guitar, bass riff/groove, bass guitar riff/groove. Here riff/groove means either word, not a literal slash. - Drum aliases: drum, drums, optionally followed by groove. - Part lists: comma, and, &, +; separate positive mentions also combine. Prefix only or suffix only selects that whole contiguous list. Example: only bass and drums; lead and bass only. - Exclusions: no/without/exclude plus a contiguous part list. no drums selects lead+bass; without bass and drums selects lead. Exclusions alone subtract from all three and disclose that baseline. Positive/excluded overlap, an outside positive part after only-selection, or an empty selection is an error unless structured parts override it. Ambiguous negated-only syntax is rejected. - Subdivision: quarter, eighth, sixteenth, optionally " note"/" notes" or "-note"/"-notes". Exact slots are 1,1/2,1/4 quarter-note beats. - Rest policy: rest/rests omits the final slot of every bar; no rest/no rests omits none. No arbitrary rest schedule. - Template: rock or metal; simple original policies, not genre fidelity. - slow/fast are fixed tempo candidates 80/160 BPM. Distinct numeric/qualitative candidates conflict without a structured tempo override. - normal and sustain are the same global normal technique, not CC64. - palm mute, palm-mute, palm muted, palm-muted retain canonical palm_mute. Composition must validate it against every selected profile, even for silence. Defaults, each disclosed as an assumption when omitted: 120 BPM, four bars, 4/4, E minor, lead+bass+drums, eighth, rock, no_rests, normal. Seed is the existing request seed (default 0), not a parsed text instruction. Only these exact filler words are ignored: please create generate make write a an the some simple music pattern groove for with and at in of on notes note key tempo meter straight Comma, period, semicolon, colon, !, ?, &, + are separators. Other unknown tokens/punctuation fail. Require a recognized instruction or music/pattern/ groove: filler-only "please" fails. No bassoon->bass or leadership->lead match. Negation is supported only for the documented part and rest grammar. Unsupported instruments, modes, other techniques, vendor-name selection, triplets, swing, polyrhythm, sections, audio and changing instructions fail, not disappear into a default. then/to/from, changes/changing, ramp, accelerando/ritardando/rallentando, speed up and slow down are rejected. No song sections, per-part instructions, arbitrary dynamics/rests/durations, chord/individual-note syntax or extra modes are claimed. DescriptionConflictError is an UnsupportedDescriptionError subtype with UNSUPPORTED_DESCRIPTION and the field to correct. Other unsupported/invalid text uses UnsupportedDescriptionError; invalid mutated request models use InvalidRequestError. The composer uses named CompositionError for unsafe intent/range/voice/channel/coverage/budget conditions and preserves exact timing/profile errors. UnsupportedArticulationError identifies part, profile and unavailable requested technique. No raw network/vendor inference exists. COMPOSITION POLICY - Common score origin 0 and exact end bars*numerator*4/denominator quarter beats. Each part and actual MIDI EOT share this duration, including rests. - Slots restart per bar. Only the final slot may shorten to the bar boundary, e.g. quarter notes in 7/8 end with 1/2 beat. This is explicit truncation of a note slot, never a change to requested musical length. - Rests remove the final slot/hits of every bar. A single-slot bar can be entirely silent and still retain its full shared duration. - Major intervals 0,2,4,5,7,9,11; natural minor 0,2,3,5,7,8,10. Require the full lead scale or bass root/fifth pair inside actual map range. Choose the root nearest 64 for lead, 40 for bass among valid palettes; lower root breaks ties. MIDI octave convention C4=60, E4=64, E2=40. No clamping, dropped degrees, chromatic pitches or invented vendor ranges. - Lead zero-based rock degrees (0,2,4,6), metal (0,0,4,1), with each bar's first slot root; other slots add seeded 0/1 modulo seven. Bass rock alternates root/fifth; metal uses root,root,fifth,root. - Drums resolve closed_hat, kick and snare aliases through the selected map. Hat each active slot; pulse=max(subdivision,4/denominator). At pulse-aligned slots alternate kick/snare from kick each bar. Metal adds off-pulse kick. This explicit odd/compound-meter policy is not automatic grouping or a claim of idiomatic 6/8 accents. - Pitched gates fill slots; drum gates=min(slot length,1/4 beat). Same-pitch notes never overlap; compiler releases before boundary retriggers. - Intensities are seeded choices 0.5,0.625,0.75, shared by simultaneous hits. Profiles perform their supported real velocity conversion. - Local Random(seed+0/1/2 for lead/bass/drums) never changes global state. Adding/reordering parts does not perturb another part's notes. - Before note allocation, exact active-slot/hit counts reserve at least note-on/off pairs within 100,000 events. The compiler still validates extra controls. Extreme valid requests fail early without excessive allocation. - Existing exact tick helpers check total/slot/gate timing; no rounding. Default 960 PPQ supports every documented straight grid and meter. Only existing real standard.lead.v1, standard.bass.v1, standard.gm-drums.v1 are selected in production integration, with normal/sustain and channels 0/1/9. No keyswitches/CCs/pedal/program/bank/GM initialization are invented. Standard palm mute fails before any artifact, never becomes softer generic MIDI. One synthetic switch-profile unit test proves real compiler/pre-roll coupling, explicitly test-only and never vendor compatibility. Keys affect actual pitches; the unchanged writer does not add key-signature meta. MEASURABLE ACTUAL-DISK EVIDENCE Tests resolve, compose, select real standard profiles, compile, exclusively write MIDI, validate actual bytes, and independently read them with Mido. Assertions cover tempo/meter, common end, track names/channels, in-key/range pitches, physical GM voices, positive velocities, and complete note pairing. Representative descriptions and independently checked ends at 960 PPQ: - Lead only: 90 BPM, 2 bars, 3/4, D major, quarter -> 5760 ticks. - Bass only: 72.5 BPM, 3 bars, 6/8, Bb minor, eighth -> 8640 ticks. - Drums only: 155 BPM, 2 bars, 7/8, sixteenth -> 6720 ticks. - All parts: 137.5 BPM, 4 bars, 4/4, F# minor, eighth -> 15360 ticks. - No drums: 111 BPM, 1 bar, 7/8, Eb major, quarter rests -> 3360 ticks. Independent exact bass case: "bass only 1 bar C major quarter", seed 0: channel 1, pitches 36/43/36/43, velocities 64/96/64/80; onsets 0/960/1920/2880, offs 960/1920/2880/3840. Independent exact drum case: quarter, 1 bar, seed 0: channel 9, kick/snare/kick/snare 36/38/36/38 plus closed hat 42; onsets 0/960/1920/2880, each gate 240 ticks; slot velocities 64/64/64/80, common EOT 3840. Expected event payloads/order are hand-specified, not copied from compiler output. For one 4/4 bar, read-back note-on counts bass/drums: quarter 4/8; eighth 8/12; sixteenth 16/20; eighth rests 7/11; eighth metal 8/16. Bass onsets are independently asserted as 960/480/240 tick grids; rest omits the final eighth onset at 3360 while EOT remains 3840. Same input/seed produces identical score/events and actual file bytes; changed seed changes content. Key changes pitches; tempo changes conductor metadata without changing tick positions; bars/meter change exact common end. Unsupported palm mute/slide/audio cases create no file or child artifact. VALIDATION — EXACT FINAL COMMANDS AND OUTCOMES Environment: existing .venv, CPython 3.13.13, Windows AMD64. No additional runtime/OS/plugin configuration is certified. No dependencies were installed/restored or manifests changed. Shell setup for test/build subprocesses (repository-local scratch): $scratch = New-Item -ItemType Directory -Force '.test-artifacts\scratch' $env:TEMP = $scratch.FullName $env:TMP = $scratch.FullName $env:TMPDIR = $scratch.FullName $env:PIP_NO_INDEX = '1' Focused final command: & '.\.venv\Scripts\python.exe' -m pytest tests\unit\test_description.py tests\unit\test_compose.py tests\integration\test_text_to_midi.py -q --tb=short PASS: 168 passed in 1.12s; 0 failed; 0 skipped. Full current suite: & '.\.venv\Scripts\python.exe' -m pytest -q --tb=short PASS: 868 passed in 32.41s; 0 failed; 0 skipped. Includes previous schemas/errors, profile/standard-map/compiler/MIDI, protocol/stdio, packaging/distribution and installed-wheel/resource regressions. Owned-file formatting: & '.\.venv\Scripts\python.exe' -m ruff format src\riff_groove_builder\description.py src\riff_groove_builder\compose.py tests\unit\test_description.py tests\unit\test_compose.py tests\integration\test_text_to_midi.py PASS: 5 files reformatted. & '.\.venv\Scripts\python.exe' -m ruff check . PASS: All checks passed. & '.\.venv\Scripts\python.exe' -m ruff format --check . PASS: 48 files already formatted. & '.\.venv\Scripts\python.exe' -m mypy --strict src tests PASS: Success: no issues found in 28 source files. Editor problems: no errors in all five new Python files. Editor runTests reported no discovered tests for supplied absolute paths; the actual repository-venv pytest CLI fallback above is the execution evidence. No failing/skipped pytest result is hidden by that discovery limitation. ISSUES ENCOUNTERED AND RESOLVED - Initial collection failed with two errors because standalone TypeAdapter(Key) used Pydantic's default Rust regex engine, which cannot compile the existing key contract's lookaround. Configured this owned adapter with strict=True and python-re, matching the authoritative contract. No shared contract was changed. - Initial Ruff found three local issues (zip strictness and long lines). Replaced zip with enumerated names and wrapped/formatted the owned code. Final whole-project lint/format and strict mypy pass without new suppressions. - Explicit tempo bounds are checked as Fraction before float conversion, so an extreme 3500-digit textual BPM yields a named error, not OverflowError. The same scalar can be replaced by a valid disclosed structured override. - Bass guitar is parsed as the bass phrase rather than accidentally requesting lead as well. Negation/only/conflict/whole-word tests verify actual behavior. - Intermediate focused checks passed 141 then 156 tests; final expanded focused count is 168 and the full suite is 868. No implementation blocker remains. CLEANUP AND LIMITATIONS All owned UUID test/build/stdio/MIDI children cleaned up; final relevant child workspace count 0, root build directory absent. Existing scratch, caches, venv, dist products and unrelated worktree content were preserved. No background processes/services were started or left running. This is tested bounded Standard MIDI composition, not a neural model, instrument emulation, genre engine, native writer or end-to-end MCP service. Real Eclips/Ray/SD3 maps, installed versions/presets, keyswitch/control behavior, vendor layering, AGP/SDP layouts and plugin/Cubase load/save/reload acceptance remain unverified. No application acceptance was run or counted as a pytest skip. RNG behavior is verified on the tested interpreter, not certified cross-runtime. Step 6 is complete and ready for review/next permitted work. Steps 7/8 real native serialization still require their existing evidence gates; this report does not claim readiness to bypass them. Step 9 service wiring is not implemented: the unchanged Step 3 handlers still list no profiles and reject valid generation requests as unfinished. No later prompt was executed. Stop here. ```