TenutoNotationLanguage

Tenuto 3.0: The Universal Language for Music and Audio

What LLVM did for software engineering and Mermaid did for diagrams, Tenuto does for music.

Tenuto is a declarative, domain‑specific language (DSL) that unifies classical music notation and modern digital signal processing (DSP) into a single, token‑efficient text format. Built on a mathematically rigorous architecture, Tenuto acts as a universal logic layer: you write the musical intent once, and the compiler can natively render it as pixel-perfect sheet music, absolute MIDI data, real‑time synthesis instructions, or native browser audio.

⚠️ The Problem Tenuto Solves

Today’s digital music landscape is fractured by a massive “Semantic Gap”:

Tenuto solves these problems by providing a semantic, archival‑safe, and editable standard. It enforces Strict Ontological Separation, decoupling what the music is (the logic/intent) from how it sounds (the physics/execution).

🤖 The AI Catalyst: Overcoming the Perceptual Gap

Large Language Models (LLMs) possess immense innate power for pattern recognition and latent-space mapping, allowing them to extract the “fossilized” structural DNA of a composition. However, they inherently suffer from polyphonic and temporal blindness. Without sensory auditory awareness, they hallucinate math and conflate layered timelines.

Tenuto is the catalyst that unlocks true AI musical expertise. If an LLM attempts to generate music using XML, it wastes its entire context window explicitly declaring redundant tags, destroying its ability to reason about macro-level structures. By forcing the AI to communicate through Tenuto’s highly constrained, token-efficient scaffolding, the LLM’s raw computational power is safely channeled into perfect acoustic reality.

🌌 The Scope of the Tenuto Ecosystem

Tenuto is not just a syntax; it is an entire suite of interrelated architectures designed to govern the future of digital audio.

1. The Core Language (T-MRL) & The Six Cognitive Engines

Tenuto’s compiler (tenutoc) doesn’t just parse notes; it dynamically routes text through Six Cognitive Physics Engines based on the instrument’s definition:

2. Tenuto Studio Architecture (TSA) & Generative Ergonomics

Tenuto was explicitly engineered to be the ultimate target language for Agentic workflows.

3. Tenuto Execution & Delegation Protocol (TEDP)

Tenuto does not reinvent audio synthesis—it orchestrates it.

4. Tenuto Engraving Architecture (TEAS)

How do you print an 808 pitch dive or an invisible sidechain LFO? You don’t.

5. Semantic Decompilation (Addendum D)

The $O(n)$ deterministic reverse-inference engine. It ingests explicit, bloated machine formats (MIDI/MusicXML) and mathematically reverse-engineers them into idiomatic Tenuto. It uses LZ77 dictionary coding to extract redundancies into $macros, and runs the Bresenham line-drawing algorithm in reverse to snap raw MIDI hits back into highly compressed Euclidean tuplets.

6. Sketch Mode (Addendum F)

For the 5-second napkin doodle. A zero-friction REPL wrapper that hides all structural boilerplate, allowing composers to type c4:8 d e f into a browser console for instant playback, with an eject command to translate the doodle into a fully scaffolded, archival-safe .ten file.

⏱️ The Rational Temporal Engine (0% Drift)

Most sequencers and DAWs suffer from floating-point quantization drift over long timelines.

Tenuto calculates time using pure Rational Arithmetic (P/Q).

⚙️ How It Works: The Pipeline

The tenutoc compiler transforms a Tenuto source file into absolute‑time instructions through a strict compilation pipeline:

graph TD
    %% Styling Definitions
    classDef layer1 fill:#0984e3,stroke:#fff,stroke-width:2px,color:#fff;
    classDef layer2 fill:#2d3436,stroke:#00b894,stroke-width:4px,color:#fff;
    classDef layer3 fill:#e67e22,stroke:#fff,stroke-width:2px,color:#fff;
    classDef layer4 fill:#d63031,stroke:#fff,stroke-width:2px,color:#fff;

    %% LAYER 1: APPLICATION
    subgraph L1["Layer 1: Application (Ingestion & Frontends)"]
        direction LR
        A1["👨‍💻 <b>Sketch Mode REPL</b><br/><i>(Zero-Friction Human Input)</i>"]:::layer1
        A2["🤖 <b>Sticky State API</b><br/><i>(15-Token/Measure LLM Input)</i>"]:::layer1
        A3["📂 <b>Semantic Decompiler</b><br/><i>(O(n) MIDI/XML Reverse Inference)</i>"]:::layer1
    end

    %% LAYER 2: NETWORK (THE NARROW WAIST)
    subgraph L2["Layer 2: Network (The Narrow Waist)"]
        IR("<b>Tenuto Universal IR</b><br/><i>Strict Ontological Separation<br/>Rational Temporal Engine<br/>(0.00% Quantization Drift)</i>"):::layer2
    end

    %% LAYER 3: TRANSPORT
    subgraph L3 ["Layer 3: Transport (Execution & Protocols)"]
        direction LR
        T1["📡 <b>TEDP (OSC)</b><br/><i>(Look-Ahead Packet Scheduling)</i>"]:::layer3
        T2["⏱️ <b>Ableton Link</b><br/><i>(Network Phase Synchronization)</i>"]:::layer3
        T3["🖨️ <b>TEAS Engine</b><br/><i>(Cassowary Layout Router)</i>"]:::layer3
    end

    %% LAYER 4: PHYSICAL
    subgraph L4 ["Layer 4: Physical (The Output Reality)"]
        direction LR
        P1["🎛️ <b>Hardware / Pro Audio</b><br/><i>(SuperCollider / MIDI 2.0)</i>"]:::layer4
        P2["🌐 <b>Native Web Browser</b><br/><i>(Wasm / Web Audio API)</i>"]:::layer4
        P3["📄 <b>Classical Publication</b><br/><i>(SVG / MusicXML 4.0)</i>"]:::layer4
    end

    %% Edge Connections (The Hourglass Flow)
    A1 -->|Raw Tenuto Text| IR
    A2 -->|Compressed AI Tokens| IR
    A3 -->|Extracted Abstract Intent| IR

    IR -->|Continuous DSP Triggers| T1
    IR -->|Rational Math Grids| T2
    IR -->|Guillotine Bounding Boxes| T3
    
    %% Direct Wasm route mapping Transport to Web
    IR -.->|Wasm Memory Bindings| P2

    T1 -->|Absolute Microseconds| P1
    T2 -->|Locked Downbeats| P1
    T3 -->|Pixel-Perfect Vectors| P3

💻 Writing Tenuto (Syntax Example)

A single .ten file can simultaneously orchestrate acoustic sheet music, continuous piano pedaling, granular sample slicing, and micro-timed electronic beats.

tenuto "3.0" {
  meta @{ 
    title: "Olympia - The Producer Suite", 
    tempo: 108, time: "4/4", 
    auto_pad_voices: true, humanize: 0.04
  }

  %% INSTRUMENT PHYSICS: We define the cognitive engines routing the code.
  def rh "Right Hand" style=relative clef=treble patch="gm_piano"
  def lh "Left Hand"  style=standard clef=bass patch="gm_piano"
  def orch "Orchestra" style=grid map=@{ sn: 38, crash: 49 }
  def vox "Vocal Chop" style=concrete src="./vocals.wav" map=@{ a:[0.0s, 1.2s] }
  def sub "808 Bass" style=synth cut_group=1

  measure 1-4 {
    lh: <[ 
      v1: eb1:2.ff[bb1 eb2 g2]:2 | bb0:2[f1 bb d2]:2 | 
      %% DECOUPLED CONTROL LANE: Press the sustain pedal for a whole note, 4 times.
      pedal: down:1 * 4 | 
    ]>
    rh: 
      %% RELATIVE PITCH: Octaves are automatically calculated based on proximity!
      [eb4 g bb eb5]:4.marc eb5:32 f g ab bb c d eb [g bb eb g]:2.marc |
      ([bb4 d5 f bb]:8 [c eb ab c] [d f bb d]):3/2[ab c eb ab]:2.pull(15ms) |
    
    orch: 
      %% EUCLIDEAN TOPOLOGY: Dynamically distribute 5 snare hits across 8 subdivisions.
      (sn:2):5/8 sn:4.roll(3) | 
      sn:16 * 16 |
    
    vox:
      %% SCHAEFFERIAN ENGINE: Slice the audio buffer into 4 mathematically equal segments
      a:2.slice(4).stretch.reverse r:2 |

    sub:
      %% SYNTH PHYSICS: A 14-bit portamento glide and a 12-semitone pitch dive.
      eb2:2.glide(150ms) eb3:2.accelerate(-12) |
      
      %% ACTION NOTATION: The 's' spacer draws an invisible CC LFO curve!
      s:2.cc(7,[127, 0], "exp") |
  }
}

🚀 Current Status & Roadmap

The Tenuto v3.0 Specification is finalized, and the core Rust compiler architecture is fully operational.

🤝 Contributing

Tenuto is an open standard and an open‑source project. We are actively seeking contributors in the following areas:

License: MIT

Tenuto: Write music as code. Compile to everything.