⚡ Ratchets — per-step sub-hits, and the glitch loop is closed

The last piece from the glitch-drum workflow: a per-step ratchet lane (1–4) —
each step can re-fire that many sub-hits within its slot, for instant rolls and
32nd-note glitch from a single step. Fired via short setTimeouts inside seqTick;
combined with Play One, every sub-hit re-rolls the note. Verified live:
rat3→3 hits, rat4→4, rat1→1, empty step→0. Self-check guards the rat default.

Now the generative loop is complete: Euclidean picks the rhythm, Play One the
pitch, ratchets the subdivision, the Groove the feel, follow-actions the
structure — and the global Scale keeps it all in key. Grimoire + manual synced.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

GODSTRUMENT_MANUAL_SOURCE.md

@@ -538,7 +538,7 @@ Learn these seven gestures and the whole planet is under your hands:
 
 - **Press `T` — tracks, for making actual songs.** A conventional tracks-and-clips view for anyone who finds the cathedral overwhelming: every voice is a **track**, eight **bars** run across, and each cell cycles **● live** (the world plays that lane) → **A** → **B** → **C** (clip patterns on the groove grids — A and B come pre-seeded so it makes music immediately) → **silent**. Double-click any clip to edit its groove in the piano roll. Press **▶** and the arrangement loops on the godtime clock — the planet still plays *through* your song, because live lanes stay wired to the world. Arrangements **save with your patch**, play out over MIDI like everything else, and **export .mid** hands you a Standard MIDI File of the note lanes to drag into Ableton, Logic, anything. Not a DAW — a sketchpad where the world sits in on your session. The panel earns its keep like one, too: a **🎛 tracks button** sits bottom-right always; **drag the panel's top edge to resize** (remembered); the top bar **tabs between clips and grooves** — the grooves tab is a full-size pattern editor (pick a track, pick a letter, big piano roll or 16 steps; double-clicking any clip jumps you straight there); and **right-click any track name for that voice's full routing menu** — every cable, every level, patch and unpatch without leaving the panel.
 
-- **The Groove — one feel for the whole pattern.** The grooves tab carries Ableton's Groove Pool, reduced to the 16-step grid: **swing** lays the off-beats back, **humanize** is a touch of random timing so nothing is machine-stiff, **velocity** lets each hit breathe in loudness, and an **amount** master scales the lot — with one-click presets (*straight, swing 16, MPC 8-4, drunk*). Under the roll sit two expression lanes: **velocity** (how hard each step hits) and **chance** (how likely each step fires at all — drop a step to 40% and it plays four times in ten, so the loop varies itself). The feel and the per-step shaping **save with your patch**. And any lane takes a **⬢ Euclidean fill** — say how many *pulses* to spread across the steps and they distribute themselves as evenly as possible (E(3,8) is the tresillo, E(5,8) the cinquillo, E(4,16) four-on-the-floor), with *steps* and *rotate* to taste: the oldest rhythms of the world fall straight out of the arithmetic.
+- **The Groove — one feel for the whole pattern.** The grooves tab carries Ableton's Groove Pool, reduced to the 16-step grid: **swing** lays the off-beats back, **humanize** is a touch of random timing so nothing is machine-stiff, **velocity** lets each hit breathe in loudness, and an **amount** master scales the lot — with one-click presets (*straight, swing 16, MPC 8-4, drunk*). Under the roll sit three expression lanes: **velocity** (how hard each step hits), **chance** (how likely each step fires at all — drop a step to 40% and it plays four times in ten, so the loop varies itself), and **ratchet** (how many times a step re-fires, 1–4 — an instant roll or 32nd-note glitch from a single step, and if that step is a Play-One stack each sub-hit re-rolls the note). The feel and the per-step shaping **save with your patch**. And any lane takes a **⬢ Euclidean fill** — say how many *pulses* to spread across the steps and they distribute themselves as evenly as possible (E(3,8) is the tresillo, E(5,8) the cinquillo, E(4,16) four-on-the-floor), with *steps* and *rotate* to taste: the oldest rhythms of the world fall straight out of the arithmetic.
 
 - **♪ One scale for the whole planet, and ⬛ Play One for the glitch.** Set a **root and scale** at the top of the grooves tab and every melody you draw is in that key — the piano roll is only ever the scale's own notes, so nothing lands wrong; change the scale and your patterns *re-harmonise* in place. And a column isn't limited to one note: **stack several** and it turns blue — a **Play One** group, from which the sequencer picks a single note at random each time it fires. Stack a handful of in-key notes under a fast Euclidean fill and the line glitches itself into something new on every pass, always in tune. (Adapted from Ableton's *Group Notes → Play One*.)
 
@@ -976,3 +976,4 @@ Every feed the world sends is one of eight temperaments; the shape dictates how
 - **⬢ Euclidean fills** — Live 12's Euclidean generator (§11.3.5): spread N `pulses` as evenly as possible over the pattern, with adjustable `steps` (cycle length) and `rotate`. E(3,8) tresillo, E(5,8) cinquillo, E(4,16) four-on-the-floor — the world's oldest rhythms falling straight out of the arithmetic. Fills any groove or gate lane.
 - **♪ Global Scale** — Live 12 Scale Awareness (§3.13): one root + scale (major, dorian, minor pentatonic, hirajoshi, …) that the whole groove editor sings in. The piano roll's rows ARE the scale degrees, so it's always folded-to-scale; change the scale and drawn patterns re-harmonise in place. Travels with the patch.
 - **⬛ Play One** — adapted from Ableton's Group Notes → Play One: a piano-roll column can hold several candidate degrees (stack them; they turn blue). On each fire the sequencer picks one at random — stack in-scale notes under a fast Euclidean fill and the line glitches itself, always in key. `.mid` export prints the first candidate.
+- **⚡ Ratchets** — a per-step `ratchet` lane (1–4): each step can re-fire that many sub-hits within its slot, for instant rolls and 32nd-note glitch from a single step. Combined with Play One, every sub-hit re-rolls the note. This completes the generative-glitch loop: Euclidean picks the rhythm, Play One the pitch, ratchets the subdivision.