# Euterpe Domain -- Features and Capabilities

> **Canonical source:** the canonical features document for this domain is
> [`deep-dive/features.md`](./deep-dive/features.md), rendered in the docs
> center. This file is its operational companion (service topology, APIs,
> schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).

> Complete music technology platform: from foundational pitch representation to
> AI-powered composition, professional production, immersive spatial audio, and
> voice synthesis.

---

## Table of Contents

1. [Music Primitives and Foundations](#1-music-primitives-and-foundations)
2. [Music Theory Intelligence](#2-music-theory-intelligence)
3. [AI Music Generation](#3-ai-music-generation)
4. [Digital Audio Workstation (DAW)](#4-digital-audio-workstation-daw)
5. [Mixing and Mastering](#5-mixing-and-mastering)
6. [Spatial and Immersive Audio](#6-spatial-and-immersive-audio)
7. [Voice Technology](#7-voice-technology)
8. [Cross-Cutting Capabilities](#8-cross-cutting-capabilities)

---

## 1. Music Primitives and Foundations

### 1.1 Pitch and Note Representation

| Capability                | Description                                                                                               |
| ------------------------- | --------------------------------------------------------------------------------------------------------- |
| Chromatic pitch classes   | All 12 chromatic tones with full sharp, flat, double-sharp, and double-flat accidental support            |
| Enharmonic equivalence    | Automatic recognition that C# and Db are the same pitch, with context-sensitive spelling                  |
| Scientific pitch notation | Notes expressed as letter-octave pairs (C4, A3, Bb5) across octaves -1 through 10                         |
| MIDI note numbers         | Full MIDI 0-127 range with bidirectional conversion between MIDI numbers, frequencies, and note names     |
| Frequency calculation     | Precise Hz frequency for any note at any tuning, with cent-level microtonal offsets                       |
| Pitch bend modeling       | Continuous pitch deviation from a base note with semitone and frequency resolution                        |
| Microtonal notes          | Arbitrary cent offsets from equal temperament for quarter-tone, sixth-tone, and custom microtonal systems |

### 1.2 Tuning Systems

| Capability              | Description                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------- |
| Standard A440           | Modern concert pitch tuning at 440 Hz                                                       |
| A432 tuning             | Alternative tuning popular in wellness and meditation music contexts                        |
| Baroque A415            | Historical tuning used for period-instrument performance at 415 Hz                          |
| Scientific pitch (C256) | Tuning system where middle C is exactly 256 Hz                                              |
| Just intonation         | Pure ratio-based tuning with perfect consonance on intervals built from whole-number ratios |
| Pythagorean tuning      | Tuning system based on stacked perfect fifths (3:2 ratios)                                  |
| Custom tuning support   | Arbitrary reference frequency and per-semitone ratio arrays for any tuning system           |

### 1.3 Notation Systems

| Capability              | Description                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------ |
| Scientific pitch        | Standard Western C4/D#5 notation                                                                             |
| Helmholtz notation      | Traditional academic notation with sub-contra through six-line octave designations                           |
| Solfege syllables       | Moveable-do and fixed-do solfege (Do, Re, Mi, Fa, Sol, La, Ti) with chromatic variants (Di, Ri, Fi, Si, Li)  |
| Nashville number system | Chord-chart notation by scale degree (1, 2, 3, etc.) used in professional session work                       |
| Indian sargam           | Sa, Re, Ga, Ma, Pa, Dha, Ni syllables for Indian classical music notation                                    |
| Byzantine neumes        | Sacred music notation with ison, oligon, petaste, kentemata, hypsele, apostrophos, elaphron, chamele symbols |

### 1.4 Intervals

| Capability             | Description                                                                                                              |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Interval construction  | Build intervals by quality (major, minor, perfect, augmented, diminished) and number (unison through compound intervals) |
| Inversion              | Automatic interval inversion (e.g., major 3rd inverts to minor 6th)                                                      |
| Quality classification | Programmatic determination of interval quality from semitone distance                                                    |
| Semitone distance      | Calculate exact semitone count between any two notes                                                                     |
| Compound intervals     | Support for intervals exceeding an octave (9ths, 10ths, 11ths, etc.)                                                     |

### 1.5 Scales, Modes, and World Music Systems

| Capability                 | Description                                                                                                |
| -------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Western diatonic scales    | Major, natural minor, harmonic minor, melodic minor, and all seven diatonic modes (Ionian through Locrian) |
| Pentatonic and blues       | Major pentatonic, minor pentatonic, blues scale                                                            |
| Symmetric scales           | Whole-tone, chromatic, diminished (half-whole and whole-half), augmented                                   |
| Bebop scales               | Bebop dominant, bebop major, bebop minor, bebop Dorian                                                     |
| Indian ragas               | Traditional raga scale systems with ascending and descending patterns                                      |
| Arabic maqamat             | Maqam scale systems used in Middle Eastern, North African, and Turkish music                               |
| Japanese scales            | Hirajoshi, Iwato, In, and other Japanese traditional scale systems                                         |
| Mode rotation              | Derive any mode from any scale by rotating the interval pattern                                            |
| Scale degree naming        | Functional names (tonic, supertonic, mediant, subdominant, dominant, submediant, leading tone/subtonic)    |
| Scale-to-chord mapping     | Automatic generation of diatonic triads and seventh chords for any scale, with Roman numeral analysis      |
| Scale search and filtering | Find scales by category, interval content, note count, or fuzzy name search                                |

### 1.6 Chords and Voicings

| Capability           | Description                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------------------- |
| Triads               | Major, minor, diminished, augmented triads from any root                                                |
| Seventh chords       | Major 7th, minor 7th, dominant 7th, half-diminished 7th, diminished 7th, minor-major 7th, augmented 7th |
| Extended chords      | 9ths, 11ths, 13ths with all quality combinations                                                        |
| Altered chords       | Altered dominants (b5, #5, b9, #9, #11, b13)                                                            |
| Suspended chords     | Sus2 and sus4 voicings                                                                                  |
| Add chords           | Add9, add11, add13 without intervening extensions                                                       |
| Power chords         | Root-fifth dyads for rock and metal contexts                                                            |
| Inversions           | Root position through third inversion with automatic note reordering                                    |
| Slash chords         | Any chord over any bass note (e.g., C/E, Am7/G)                                                         |
| Polychords           | Two simultaneous chords (upper/lower) for complex harmonic textures                                     |
| Cluster chords       | Adjacent chromatic or whole-tone tone clusters of configurable size                                     |
| Voicing strategies   | Close voicing, open voicing, drop-2, drop-3, drop-2-4, and spread voicings                              |
| Chord symbol parsing | Parse standard chord notation strings (Cmaj7, Dm7b5, F#sus4/A) into structured chord objects            |

### 1.7 Rhythm and Time

| Capability           | Description                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
| Time signatures      | Simple (4/4, 3/4, 2/4), compound (6/8, 9/8, 12/8), complex (5/4, 7/8, 11/8), and additive (2+3+2/8) meters |
| Note durations       | Whole through 128th notes with dotted, double-dotted, and tuplet variants                                  |
| Tempo representation | BPM with Italian tempo markings (Largo, Adagio, Andante, Moderato, Allegro, Vivace, Presto)                |
| Tuplet divisions     | Triplets, quintuplets, septuplets, and arbitrary n-tuplets                                                 |
| Rhythmic patterns    | Structured representation of repeating rhythmic figures                                                    |

### 1.8 Keys and Tonality

| Capability               | Description                                                                       |
| ------------------------ | --------------------------------------------------------------------------------- |
| Key signature management | All major and minor keys with correct accidental counts                           |
| Relative key detection   | Find the relative major or minor of any key                                       |
| Parallel key detection   | Find the parallel major or minor (same root, different mode)                      |
| Key detection from notes | Analyze a collection of notes to suggest the most likely key                      |
| Modulation path finding  | Calculate the smoothest modulation path between distant keys through pivot chords |

### 1.9 Musical Form and Structure

| Capability         | Description                                      |
| ------------------ | ------------------------------------------------ |
| Structural units   | Phrase, period, section, and movement hierarchy  |
| Sonata form        | Exposition, development, recapitulation template |
| Rondo form         | ABACA and ABACABA recurring theme templates      |
| Binary and ternary | AB and ABA form templates                        |
| Strophic form      | Verse-based repeating structure                  |
| Through-composed   | Non-repeating continuous form                    |

### 1.10 Dynamics and Expression

| Capability       | Description                                                               |
| ---------------- | ------------------------------------------------------------------------- |
| Dynamic markings | ppp through fff with niente (silence)                                     |
| Hairpins         | Crescendo and diminuendo with target dynamic levels                       |
| Articulations    | Staccato, legato, accent, tenuto, marcato, sforzando, and combinations    |
| Tempo modifiers  | Ritardando, accelerando, rubato, fermata, a tempo                         |
| Expression marks | Dolce, espressivo, cantabile, con fuoco, and other performance directions |

### 1.11 Audio Handling

| Capability              | Description                                                                   |
| ----------------------- | ----------------------------------------------------------------------------- |
| Audio buffer management | Create, manipulate, and transform audio buffers at any sample rate            |
| Sample rate conversion  | Convert between standard rates (22050, 44100, 48000, 88200, 96000, 192000 Hz) |
| Format detection        | Identify audio file formats from headers                                      |
| Waveform representation | Structured waveform data for visualization and analysis                       |

### 1.12 MIDI Protocol

| Capability           | Description                                                                                              |
| -------------------- | -------------------------------------------------------------------------------------------------------- |
| MIDI 1.0 messages    | Note on/off, control change, program change, pitch bend, aftertouch (channel and poly), system exclusive |
| Channel management   | Full 16-channel MIDI support with per-channel state                                                      |
| MIDI file parsing    | Read Standard MIDI Files (Type 0 and Type 1)                                                             |
| MIDI file generation | Write MIDI files from programmatic note and controller data                                              |

---

## 2. Music Theory Intelligence

### 2.1 Harmonic Analysis

| Capability             | Description                                                                |
| ---------------------- | -------------------------------------------------------------------------- |
| Roman numeral analysis | Identify chord function (I, ii, iii, IV, V, vi, vii) within a key          |
| Functional harmony     | Classify chords as tonic, dominant, subdominant, or pre-dominant function  |
| Secondary dominants    | Detect V/V, V/ii, V/vi, and other secondary dominant relationships         |
| Borrowed chords        | Identify chords borrowed from parallel modes (modal mixture)               |
| Neapolitan chords      | Detect bII (Neapolitan sixth) usage                                        |
| Augmented sixth chords | Identify Italian, French, and German augmented sixth chords                |
| Pivot chord modulation | Detect key changes through shared pivot chords between the old and new key |
| Harmonic rhythm        | Analyze the rate of harmonic change across a passage                       |

### 2.2 Counterpoint

| Capability                   | Description                                                                  |
| ---------------------------- | ---------------------------------------------------------------------------- |
| Species counterpoint         | Rules and validation for first through fifth species counterpoint            |
| Voice leading validation     | Check voice leading for parallel fifths, parallel octaves, and hidden fifths |
| Dissonance treatment         | Validate proper preparation, suspension, and resolution of dissonances       |
| Melodic interval constraints | Enforce rules about allowable melodic intervals in each voice                |
| Cantus firmus generation     | Generate valid cantus firmus melodies following traditional rules            |

### 2.3 Melody Analysis and Generation

| Capability                 | Description                                                                       |
| -------------------------- | --------------------------------------------------------------------------------- |
| Contour analysis           | Classify melodic contour as ascending, descending, arch, inverted arch, or static |
| Range analysis             | Determine the ambitus (range) and tessitura of a melody                           |
| Climax identification      | Locate the registral and emotional climax points of a melody                      |
| Motivic pattern detection  | Identify recurring motifs, sequences, and thematic transformations                |
| Conjunct/disjunct analysis | Measure the balance of stepwise versus leaping motion                             |
| Melody generation          | Create melodies constrained by harmonic context, range, and stylistic parameters  |

### 2.4 Chord Progressions

| Capability                 | Description                                                                                        |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| Pattern catalog            | Common progressions organized by genre and style (I-IV-V-I, ii-V-I, I-V-vi-IV, 12-bar blues, etc.) |
| Progression generation     | Generate harmonically valid progressions with voice leading optimization                           |
| Progression analysis       | Analyze existing chord sequences for functional harmony and cadence types                          |
| Voice leading optimization | Minimize voice movement between chords for smooth part writing                                     |

### 2.5 Groove and Quantization

| Capability            | Description                                                                            |
| --------------------- | -------------------------------------------------------------------------------------- |
| Straight quantization | Snap notes to the nearest grid position at any subdivision                             |
| Swing quantization    | Apply shuffle and swing feel with configurable ratios                                  |
| Groove templates      | Apply recorded groove feels from real performances                                     |
| Humanization          | Add natural timing variation, velocity differences, and micro-timing to rigid patterns |
| Groove extraction     | Extract groove templates from performance recordings for reuse                         |

### 2.6 Pitch Class Set Theory

| Capability              | Description                                                                                |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| Prime form calculation  | Reduce pitch class sets to prime form for classification                                   |
| Normal order            | Compute the most compact ordering of a pitch class set                                     |
| Forte number lookup     | Identify sets by their standard Forte catalog number                                       |
| Interval vector         | Calculate the interval content vector of any pitch class set                               |
| Z-relation detection    | Identify Z-related pairs (sets sharing the same interval vector but different prime forms) |
| Transformational theory | Apply transposition, inversion, and multiplication operations to pitch class sets          |

### 2.7 Orchestration

| Capability              | Description                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------------------- |
| Instrument ranges       | Comprehensive database of standard, professional, and extended ranges for orchestral instruments         |
| Transposition data      | Instrument transposition tables for all transposing instruments (Bb clarinet, F horn, Eb alto sax, etc.) |
| Scoring guidelines      | Instrument-family scoring conventions and best practices                                                 |
| Combination suggestions | Recommend effective instrument combinations for specific timbral goals                                   |
| Balance analysis        | Evaluate orchestral balance across registers and families                                                |
| Voicing distribution    | Distribute chord tones across instruments with appropriate doublings and spacings                        |

### 2.8 Genre Classification

| Capability                    | Description                                                                                       |
| ----------------------------- | ------------------------------------------------------------------------------------------------- |
| Feature extraction            | Extract stylistic features (tempo range, rhythmic patterns, harmonic vocabulary, instrumentation) |
| Genre classification          | Classify musical passages by genre based on structural characteristics                            |
| Style-appropriate suggestions | Recommend compositional choices appropriate to a target genre                                     |

### 2.9 Ear Training

| Capability                | Description                                                     |
| ------------------------- | --------------------------------------------------------------- |
| Interval recognition      | Generate ascending, descending, and harmonic interval exercises |
| Chord quality recognition | Practice identifying chord types by ear                         |
| Scale identification      | Exercises for recognizing scales and modes                      |
| Progression dictation     | Dictation exercises for chord progression recognition           |
| Difficulty progression    | Graduated difficulty levels with performance tracking           |

### 2.10 Notation

| Capability                  | Description                                                         |
| --------------------------- | ------------------------------------------------------------------- |
| Clef assignment             | Determine appropriate clef for any pitch range                      |
| Beam grouping               | Calculate correct rhythmic beam groupings per time signature        |
| Tie and slur logic          | Generate ties for held notes across barlines and slurs for phrasing |
| Notation export preparation | Prepare musical data for rendering by notation software             |

---

## 3. AI Music Generation

### 3.1 Text-to-Music

| Capability                   | Description                                                                 |
| ---------------------------- | --------------------------------------------------------------------------- |
| Natural language prompts     | Generate music from descriptions like "upbeat funk groove with brass stabs" |
| Style control                | Specify genre, era, and stylistic influences through text                   |
| Instrumentation control      | Request specific instruments and ensembles through natural language         |
| Mood and energy              | Control emotional character and energy level through descriptive prompts    |
| Structure specification      | Define song structure (intro, verse, chorus, bridge) in text prompts        |
| Diffusion-based generation   | Use diffusion models for high-quality audio generation                      |
| Transformer-based generation | Leverage transformer architectures for structured music creation            |

### 3.2 Stem Separation

| Capability                | Description                                                                 |
| ------------------------- | --------------------------------------------------------------------------- |
| Multi-stem separation     | Separate mixed audio into vocals, drums, bass, and other instruments        |
| Selective regeneration    | Regenerate individual stems while preserving others                         |
| Remix workflows           | Enable remixing by providing isolated instrument tracks from finished mixes |
| Neural network separation | Deep learning models trained for high-quality source separation             |

### 3.3 Voice Generation

| Capability                   | Description                                              |
| ---------------------------- | -------------------------------------------------------- |
| Singing voice synthesis      | Generate sung vocals from lyrics and melody input        |
| Vocal style transfer         | Apply one singing style to different melodic content     |
| Voice-conditioned generation | Generate music that matches or complements a given vocal |

### 3.4 Melody Generation

| Capability                   | Description                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------- |
| Harmonic context constraints | Generate melodies that fit a given chord progression                             |
| Style parameters             | Control melodic style through range, rhythm complexity, and interval preferences |
| Rule-based generation        | Classical composition rules for melodically valid output                         |
| Neural melody generation     | AI models trained on large melodic corpora for creative generation               |

### 3.5 Arrangement

| Capability              | Description                                                               |
| ----------------------- | ------------------------------------------------------------------------- |
| Lead sheet expansion    | Transform a melody and chords into a full multi-instrument arrangement    |
| Instrument distribution | Automatically assign parts to appropriate instruments                     |
| Voicing generation      | Create appropriate voicings for each instrument based on range and idiom  |
| Dynamic arrangement     | Generate dynamic variation across sections (verse sparser, chorus fuller) |

### 3.6 Audio Inpainting

| Capability       | Description                                                                       |
| ---------------- | --------------------------------------------------------------------------------- |
| Region fill      | Fill selected regions of audio with contextually appropriate generated content    |
| Seamless editing | Ensure generated content matches surrounding audio in timbre, dynamics, and style |
| Extension        | Extend existing recordings by generating continuation material                    |

### 3.7 Style Transfer

| Capability              | Description                                                                     |
| ----------------------- | ------------------------------------------------------------------------------- |
| Cross-genre adaptation  | Transform music from one genre to another while preserving melody and structure |
| Structural preservation | Maintain phrase structure and harmonic framework during style transformation    |
| Identity preservation   | Keep the recognizable musical identity while changing stylistic characteristics |

### 3.8 Conditional Generation

| Capability                  | Description                                                                  |
| --------------------------- | ---------------------------------------------------------------------------- |
| Multi-constraint generation | Generate music satisfying multiple simultaneous constraints                  |
| Chord-conditioned           | Constrain generation to follow a specific chord progression                  |
| Rhythm-conditioned          | Match a given rhythmic pattern while generating harmonic and melodic content |
| Energy curve conditioning   | Shape the overall energy and dynamics of generated music over time           |
| Instrumentation constraints | Generate only for specified instrument combinations                          |

### 3.9 Quality Assessment

| Capability                | Description                                                                 |
| ------------------------- | --------------------------------------------------------------------------- |
| Perceptual metrics        | Evaluate generated audio using perceptual quality measures                  |
| Musical coherence scoring | Assess harmonic, melodic, and rhythmic coherence of generated music         |
| Artifact detection        | Identify audio artifacts, glitches, and quality issues in generated content |

### 3.10 Generation Infrastructure

| Capability         | Description                                                  |
| ------------------ | ------------------------------------------------------------ |
| Model loading      | Efficient loading and initialization of generative models    |
| GPU/CPU dispatch   | Automatic hardware selection for optimal inference speed     |
| Inference batching | Batch multiple generation requests for throughput efficiency |
| Result caching     | Cache frequently requested generations to reduce computation |
| Model versioning   | Track and switch between model versions for A/B comparison   |

---

## 4. Digital Audio Workstation (DAW)

### 4.1 Core Audio Engine

| Capability               | Description                                                                                                                                                                            |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Real-time audio graph    | Node-based audio processing graph with gain, filter, delay, compressor, analyser, oscillator, panner, convolver, waveshaper, stereo panner, channel merger/splitter, and worklet nodes |
| Sample rates             | Support for 22050, 44100, 48000, 88200, 96000, and 192000 Hz                                                                                                                           |
| Bit depths               | 16-bit, 24-bit, and 32-bit float processing                                                                                                                                            |
| Buffer sizes             | Configurable from 32 to 4096 samples for latency/performance trade-off                                                                                                                 |
| Transport controls       | Play, pause, stop, record, and loop with sample-accurate timing                                                                                                                        |
| Latency compensation     | Automatic plugin delay compensation across the entire signal chain                                                                                                                     |
| AudioWorklet support     | Custom DSP processors via the AudioWorklet API                                                                                                                                         |
| WebAssembly DSP          | Load custom WASM DSP modules for high-performance processing (filter, dynamics, reverb, delay, distortion, analysis)                                                                   |
| Worker thread processing | Multi-threaded audio processing with configurable thread count and priority                                                                                                            |
| Buffer pool management   | Memory-efficient buffer pooling with LRU, LFU, or FIFO eviction policies and hit-rate tracking                                                                                         |
| Offline rendering        | Bounce to file (WAV, MP3, FLAC, OGG) with configurable sample rate, bit depth, normalization, and dithering                                                                            |
| Real-time streaming      | Stream audio output in PCM, MP3, or OGG format with underrun monitoring                                                                                                                |
| MIDI device management   | Enumerate, connect, and receive from MIDI input/output devices with hot-plug support                                                                                                   |
| Audio device management  | Select input/output audio devices with sample rate and buffer size configuration                                                                                                       |

### 4.2 Timeline and Arrangement

| Capability             | Description                                                               |
| ---------------------- | ------------------------------------------------------------------------- |
| Track lanes            | Unlimited audio and MIDI tracks with independent settings                 |
| Region management      | Place, move, split, and merge audio regions on the timeline               |
| Markers and locators   | Named markers, loop regions, and arrangement markers                      |
| Tempo map              | Multiple tempo changes within a project with smooth or sudden transitions |
| Time signature changes | Change meter at any point in the timeline                                 |
| Timeline navigation    | Zoom, scroll, snap-to-grid, and ruler display at multiple resolutions     |

### 4.3 Clip Editing

| Capability              | Description                                                                |
| ----------------------- | -------------------------------------------------------------------------- |
| Non-destructive editing | All edits preserve the original audio data                                 |
| Cut, copy, paste        | Standard clipboard operations on audio regions                             |
| Trim and crop           | Adjust clip boundaries without altering the underlying audio               |
| Fade in/out             | Configurable fade curves (linear, exponential, S-curve) at clip boundaries |
| Crossfade               | Automatic crossfades between overlapping clips                             |
| Time stretch            | Change clip duration without affecting pitch                               |
| Pitch shift             | Transpose clips without affecting duration                                 |

### 4.4 MIDI Editing

| Capability          | Description                                                                 |
| ------------------- | --------------------------------------------------------------------------- |
| Piano roll editor   | Graphical note placement and editing with pitch and time axes               |
| Step sequencer      | Grid-based note entry for pattern programming                               |
| MIDI quantization   | Snap MIDI notes to grid with adjustable strength and swing                  |
| Velocity editing    | Per-note velocity adjustment with pencil, line, and curve tools             |
| Controller lanes    | Edit CC data (modulation, expression, sustain, etc.) in dedicated lanes     |
| MIDI transformation | Transpose, scale velocity, randomize, and apply algorithmic transformations |

### 4.5 Mixer

| Capability          | Description                                                |
| ------------------- | ---------------------------------------------------------- |
| Channel strips      | Gain staging, pan, mute, solo for every track              |
| Send/return routing | Auxiliary send buses for shared effects processing         |
| Bus grouping        | Group channels for collective level and processing control |
| Master output       | Final output channel with metering                         |
| Metering            | Peak, RMS, and LUFS level metering on all channels         |

### 4.6 Effects Processing

| Capability              | Description                                                                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Parametric EQ           | Up to 8 bands with low shelf, high shelf, peaking, lowpass, highpass, bandpass, notch, and allpass filter types; per-band frequency, gain, and Q control |
| Compressor              | VCA, FET, and optical circuit models with threshold, ratio, attack, release, knee, and makeup gain; gain reduction metering                              |
| True-peak limiter       | Ceiling, release, lookahead, and true-peak detection for broadcast-safe limiting                                                                         |
| Reverb                  | Algorithmic (hall, room, plate, chamber, spring) and convolution modes with room size, decay, damping, pre-delay, diffusion, and early reflections       |
| Delay                   | Stereo, ping-pong, and tape modes with tempo sync, filter, modulation, and feedback                                                                      |
| Chorus, flanger, phaser | Modulation effects with rate, depth, feedback, LFO waveform (sine, triangle, square, sawtooth), and stereo spread                                        |
| Distortion/saturation   | Tube, transistor, tape, digital, and fuzz algorithms with drive, tone, and oversampling                                                                  |
| Filter                  | Lowpass, highpass, bandpass, and notch filters with slopes from 6 to 48 dB/octave and resonance drive                                                    |
| Gate/expander           | Gate and expander modes with threshold, ratio, attack, hold, release, range, and lookahead                                                               |
| De-esser                | Wideband, split, and dynamic modes with frequency, threshold, bandwidth, and listen mode                                                                 |
| Pitch correction        | Chromatic and scale-based auto-tune with retune speed, humanize amount, formant preservation, and per-note targeting                                     |
| Vocoder                 | 4 to 64 bands with formant shift, envelope control, and unvoiced segment handling                                                                        |
| Stereo widener          | Width control with mono-below-frequency and mono compatibility checking                                                                                  |
| Multiband dynamics      | 2 to 5 bands with per-band compression, crossover slopes, solo/mute, and gain reduction metering                                                         |
| Transient shaper        | Independent attack and sustain enhancement/reduction with sensitivity control                                                                            |

### 4.7 Virtual Instruments

| Capability                | Description                                                                                                                                                               |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sample-based instruments  | Key/velocity-mapped sample playback with loop points, ADSR envelopes, and pitch bend                                                                                      |
| Wavetable synthesizer     | Multi-oscillator wavetable morphing with position scanning, filter envelopes, and LFO modulation                                                                          |
| Subtractive synthesizer   | Three oscillators (sine, saw, square, triangle, noise) with white/pink noise, resonant filter, dual LFOs, key tracking, and glide                                         |
| FM synthesizer            | Multi-operator FM synthesis with configurable algorithms, per-operator envelopes, feedback, and modulation index                                                          |
| Granular synthesizer      | Granular audio processing with grain size, density, position scatter, pitch spread, window shapes (Hann, Gaussian, triangle, trapezoid), and pan spread                   |
| Drum machine              | Multi-pad drum kits with per-pad sample, volume, pan, pitch, choke groups, filter, and send levels; step sequencer with swing                                             |
| Bass synthesizer          | Dedicated bass instrument with sub-oscillator, filter envelope, distortion (soft, hard, foldback), and glide; preset categories (sub, acid, reese, pluck, wobble, growl)  |
| Pad/string synthesizer    | Unison voices (up to 16) with detune and stereo spread, slow envelopes, built-in chorus, reverb send, and LFO                                                             |
| Lead synthesizer          | Dual oscillator with pulse width modulation, portamento (always/legato), delayed vibrato, and monophonic mode                                                             |
| Arpeggiator               | Up (ascending), down, up-down, down-up, random, and order modes with note value, octave range, gate length, swing, latch, and custom step patterns                        |
| Chord generator           | 16 chord types, inversions 0-3, voicing styles (close, open, drop-2, drop-3, spread), octave shift, and strum timing                                                      |
| Multi-zone sampler        | Multiple sample zones with key/velocity ranges, loop modes (off, forward, ping-pong), round-robin groups, and velocity curves (linear, logarithmic, exponential, S-curve) |
| SoundFont player          | Full SF2 file parsing with preset/bank selection, generator support, multi-zone instruments, and ADSR envelopes                                                           |
| Physical modeling         | Karplus-Strong string synthesis, waveguide wind instruments, and resonator percussion with material types (metal, wood, glass, membrane)                                  |
| AI instrument suggestions | Context-aware instrument recommendations based on genre, mood, tempo, key, and existing instrumentation with preset and parameter hints                                   |

### 4.8 Automation

| Capability           | Description                                                               |
| -------------------- | ------------------------------------------------------------------------- |
| Breakpoint editing   | Place and adjust automation points on any parameter                       |
| Automation curves    | Linear, bezier, and step interpolation between breakpoints                |
| Automation lanes     | Dedicated automation lane per parameter per track                         |
| Controller recording | Record automation from MIDI controllers and control surfaces in real time |

### 4.9 Project Management

| Capability            | Description                                                   |
| --------------------- | ------------------------------------------------------------- |
| Session save/load     | Persistent project files with full state serialization        |
| Audio file references | Managed references to audio files with missing-file detection |
| Undo/redo history     | Full unlimited undo/redo stack for all editing operations     |
| Project export        | Export completed projects as audio files in multiple formats  |

### 4.10 AI-Assisted Production

| Capability           | Description                                                        |
| -------------------- | ------------------------------------------------------------------ |
| Auto-mixing          | AI-powered automatic mixing with balanced levels, panning, and EQ  |
| Intelligent EQ       | Analyze audio and suggest corrective EQ curves                     |
| Mastering assistance | One-click mastering suggestions based on genre and target platform |
| Audio repair         | AI-powered removal of noise, clicks, hum, and other artifacts      |

---

## 5. Mixing and Mastering

### 5.1 Mastering Signal Chain

| Capability            | Description                                                                                                             |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Multiband compression | Split-band dynamics processing for frequency-specific control                                                           |
| Stereo enhancement    | Mid/side processing and stereo image widening                                                                           |
| Harmonic excitation   | Add subtle harmonics for warmth and presence                                                                            |
| Brick-wall limiting   | True-peak limiting for final loudness maximization without clipping                                                     |
| LUFS normalization    | Target specific loudness levels per streaming platform (Spotify -14 LUFS, Apple Music -16 LUFS, YouTube -14 LUFS, etc.) |

### 5.2 Mix Analysis

| Capability                 | Description                                                               |
| -------------------------- | ------------------------------------------------------------------------- |
| Spectral analysis          | Full-spectrum frequency content visualization and analysis                |
| Dynamic range measurement  | Crest factor analysis and dynamic range statistics                        |
| Stereo field visualization | Lissajous/goniometer and correlation metering for stereo image assessment |
| LUFS metering              | Integrated, short-term, and momentary loudness measurement                |
| True peak detection        | Sample-accurate peak measurement that accounts for inter-sample peaks     |

### 5.3 Stem Mastering

| Capability          | Description                                                                                                   |
| ------------------- | ------------------------------------------------------------------------------------------------------------- |
| Per-stem processing | Apply mastering-grade processing to individual stems (drums, bass, vocals, instruments) before final limiting |
| Stem-level control  | Greater control than stereo mastering by adjusting balance between stems                                      |
| Final limiting      | Combined limiting after stem processing for cohesive loudness                                                 |

### 5.4 Format Conversion

| Capability             | Description                                                                   |
| ---------------------- | ----------------------------------------------------------------------------- |
| Sample rate conversion | High-quality conversion between all standard sample rates                     |
| Bit depth dithering    | Apply dithering when reducing bit depth to minimize quantization noise        |
| Codec encoding         | Export to WAV, FLAC, AAC, MP3, and Opus with format-specific quality settings |
| Metadata embedding     | Embed ID3 tags, FLAC comments, and format-specific metadata                   |

### 5.5 AI Mix Assistant

| Capability                 | Description                                                                |
| -------------------------- | -------------------------------------------------------------------------- |
| Spectral balance analysis  | Compare mix frequency balance against genre-appropriate reference curves   |
| Dynamic range assessment   | Evaluate compression and limiting against genre norms                      |
| Reference track comparison | A/B compare a mix against reference tracks for tonal and dynamic matching  |
| Improvement suggestions    | Actionable suggestions for EQ, compression, level, and spatial adjustments |

---

## 6. Spatial and Immersive Audio

### 6.1 Dolby Atmos Authoring

| Capability             | Description                                                                    |
| ---------------------- | ------------------------------------------------------------------------------ |
| Object-based audio     | Position sound sources as 3D objects in space with per-object metadata         |
| Bed channel management | Configure and manage static bed channels for the base sound field              |
| ADM file creation      | Generate Audio Definition Model files conforming to Dolby Atmos specifications |
| Renderer integration   | Interface with Dolby Atmos renderer for monitoring and delivery                |
| Metadata generation    | Create Dolby Atmos compliant metadata for streaming and broadcast delivery     |

### 6.2 Binaural Audio

| Capability                | Description                                                                       |
| ------------------------- | --------------------------------------------------------------------------------- |
| HRTF processing           | 3D spatial rendering for headphones using Head-Related Transfer Functions         |
| HRTF database management  | Store and select from multiple HRTF measurement datasets                          |
| Personalized HRTF         | Estimate individualized HRTFs from ear measurements or photos                     |
| Head tracking integration | Accept head tracking data for responsive spatial audio that follows head movement |

### 6.3 Higher-Order Ambisonics

| Capability             | Description                                                              |
| ---------------------- | ------------------------------------------------------------------------ |
| HOA encoding           | Encode sources into higher-order ambisonic signals (B-format and higher) |
| HOA decoding           | Decode ambisonic signals to arbitrary speaker arrays                     |
| Rotation               | Rotate the entire ambisonic sound field in three axes                    |
| Beamforming            | Extract directional audio from ambisonic recordings                      |
| Speaker-array decoding | Decode to common speaker layouts (5.1, 7.1, dome arrays, etc.)           |

### 6.4 VR/AR Audio

| Capability                   | Description                                                                   |
| ---------------------------- | ----------------------------------------------------------------------------- |
| Room acoustics simulation    | Simulate realistic room reflections and reverb based on virtual room geometry |
| Distance attenuation         | Model realistic volume falloff with distance in 3D environments               |
| Occlusion modeling           | Reduce and filter audio when virtual objects block the sound path             |
| Real-time source positioning | Move audio sources in 3D space synchronized with scene updates                |
| Scene-linked audio           | Tie audio properties to 3D scene state for interactive experiences            |

### 6.5 AI Spatial Upmix

| Capability                   | Description                                                                   |
| ---------------------------- | ----------------------------------------------------------------------------- |
| Stereo-to-immersive          | Convert stereo mixes to spatial formats using AI analysis                     |
| Intelligent distribution     | Analyze source material to identify instruments and place them spatially      |
| Artistic intent preservation | Maintain the original mix's artistic balance while adding spatial dimension   |
| Multi-format output          | Output to Dolby Atmos, ambisonics, binaural, or custom speaker configurations |

---

## 7. Voice Technology

### 7.1 Voice Cloning

| Capability              | Description                                                                   |
| ----------------------- | ----------------------------------------------------------------------------- |
| Reference-based cloning | Create synthetic voice models from audio samples of a target speaker          |
| Narration synthesis     | Use cloned voices for narration, audiobook, and dialogue generation           |
| Singing voice cloning   | Clone singing voices for music production                                     |
| Speaker verification    | Verify that input audio matches the authorized speaker for consent management |
| Consent management      | Built-in consent tracking to ensure ethical use of cloned voices              |

### 7.2 Voice Conversion

| Capability                 | Description                                                           |
| -------------------------- | --------------------------------------------------------------------- |
| Real-time conversion       | Transform voice characteristics in real time for live applications    |
| Offline conversion         | High-quality batch voice conversion for post-production               |
| Encoder-decoder approach   | Neural encoder-decoder models for voice transformation                |
| GAN-based conversion       | Generative adversarial network models for natural-sounding conversion |
| Diffusion-based conversion | Diffusion model approaches for highest-quality results                |
| Linguistic preservation    | Preserve speech content and intelligibility during conversion         |

### 7.3 Text-to-Speech

| Capability             | Description                                                               |
| ---------------------- | ------------------------------------------------------------------------- |
| Multi-language support | Generate speech in multiple languages with native pronunciation           |
| Speaking styles        | Switch between conversational, formal, narration, and presentation styles |
| Emotion control        | Adjust emotional expression (happy, sad, excited, calm, angry)            |
| SSML markup            | Support for Speech Synthesis Markup Language for precise prosody control  |
| Prosody adjustment     | Fine-tune pitch, rate, volume, and pausing at the sentence and word level |

### 7.4 Text-to-Singing

| Capability            | Description                                                               |
| --------------------- | ------------------------------------------------------------------------- |
| Lyrics-to-vocals      | Generate sung vocals from lyrics text and melody input                    |
| Vocal style selection | Choose from multiple vocal styles (pop, opera, jazz, folk, etc.)          |
| Vibrato control       | Adjust vibrato depth, rate, and onset characteristics                     |
| Breath simulation     | Model realistic breathing between phrases                                 |
| Expression parameters | Control dynamics, vowel shaping, consonant articulation, and vocal effort |

### 7.5 Vocal Processing

| Capability       | Description                                                              |
| ---------------- | ------------------------------------------------------------------------ |
| Pitch correction | Transparent and aggressive auto-tune modes with scale-aware correction   |
| Formant shifting | Shift vocal formants independently of pitch for character modification   |
| Vocal doubling   | Generate natural-sounding doubled vocals with timing and pitch variation |
| Harmonizer       | Intelligent harmony generation based on key and chord context            |
| De-essing        | Reduce sibilance without affecting overall vocal quality                 |
| Breath removal   | Detect and remove or reduce breath sounds between phrases                |

### 7.6 Choir Simulation

| Capability        | Description                                                                            |
| ----------------- | -------------------------------------------------------------------------------------- |
| Virtual ensemble  | Generate multiple virtual singers from a single voice input                            |
| Natural variation | Apply realistic variation in timing, pitch, vibrato, and timbre across virtual singers |
| Section control   | Control soprano, alto, tenor, and bass sections independently                          |
| Choral texture    | Create authentic choir textures from solo performances                                 |

### 7.7 Voice Analysis

| Capability                   | Description                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------- |
| Pitch tracking               | Continuous fundamental frequency tracking for singing and speech                |
| Formant analysis             | Extract and visualize vocal formant frequencies                                 |
| Voice quality assessment     | Evaluate breathiness, nasality, brightness, and other timbral qualities         |
| Singing technique evaluation | Assess vibrato consistency, pitch accuracy, breath support, and dynamic control |
| Vocal range detection        | Determine a singer's comfortable range and extremes                             |

---

## 8. Cross-Cutting Capabilities

### 8.1 Platform Integration

| Capability               | Description                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| Zero-dependency core     | The core music primitives library has no runtime dependencies, usable in any JavaScript/TypeScript environment |
| Web Audio API compatible | Audio processing designed for compatibility with the Web Audio API standard                                    |
| Cross-platform           | All libraries work in Node.js, browser, and Electron environments                                              |
| Layered architecture     | Consume only the layers needed -- use just core for music theory, add studio for DAW features, etc.            |

### 8.2 Multi-Genre and Multi-Cultural Support

| Capability               | Description                                                                                                                       |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| Western tonal music      | Complete support for common-practice tonal harmony and modern pop/rock/jazz theory                                                |
| Indian classical music   | Raga systems, sargam notation, and microtonal support                                                                             |
| Arabic and Turkish music | Maqam scales with quarter-tone and custom interval support                                                                        |
| Byzantine sacred music   | Neume notation and modal systems                                                                                                  |
| Microtonal music         | Arbitrary cent offsets, custom tuning systems, and non-12-TET temperaments                                                        |
| Global genre support     | Genre classification and style suggestions spanning 21+ genre categories from electronic and hip-hop to world music and classical |

### 8.3 AI and Machine Learning

| Capability             | Description                                                           |
| ---------------------- | --------------------------------------------------------------------- |
| Generative composition | AI-powered music creation from text, constraints, or style references |
| Intelligent analysis   | Automated harmonic, melodic, and structural analysis                  |
| Smart mixing           | AI-assisted mixing decisions for EQ, dynamics, and spatial placement  |
| Quality assessment     | Automated evaluation of musical and audio quality                     |
| Instrument suggestions | Context-aware AI recommendations for instrumentation and sound design |
| Style understanding    | AI models that understand musical genre, mood, and style conventions  |

### 8.4 Professional Audio Standards

| Capability                   | Description                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------ |
| Broadcast loudness standards | LUFS metering and normalization for broadcast compliance (EBU R128, ATSC A/85) |
| Dolby Atmos                  | Full Dolby Atmos authoring and metadata support                                |
| MIDI 1.0                     | Complete MIDI protocol implementation                                          |
| SF2 SoundFont                | Full SoundFont 2 file format support                                           |
| Industry standard formats    | WAV, FLAC, AAC, MP3, Opus encoding and decoding                                |
| True peak metering           | ITU-R BS.1770 compliant true peak measurement                                  |
