The vibe name + emoji arrive from user-pasted GSV1 codes and #vibe= URL fragments
and are rendered via innerHTML in the vibes panel + the shared-vibe offer card.
name was <-escaped but emoji was raw. sanitizeVibe now strips [<>&"'`] from both
at the trust boundary, so nothing dangerous reaches any render path.
Verified live: a crafted code with name='<img onerror=…>' + emoji='<svg onload=…>'
imported via #vibe= → no <img>/<svg> in the DOM, no script fired, both rendered as
inert text. (ship-check item 3: user strings → HTML must be escaped.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Canon (viz/index.html grimoire) is truth; manual synced to match.
- grimoire: two new tech-manual sections in the OMNI/Earth-Echo/GODSONIQ style
(numbered how-to + spec table) — 'Building from zero — the empty instrument'
(rings → orbs → drag/tap routing → synth-roll → keep/weave exit → persistence)
and 'OMNI — the synth panel' (live arcs, trim-riding knobs, engine selector,
earth echo, transport). Rewrote 'Saving your instrument' as dimensions & vibes.
- manual (had drifted — still said MY PATCHES): added Building-from-zero + the
🎹 OMNI panel; 'Saving' → dimensions & vibes; keymap now lists F11 zero + O.
Verified: grimoire renders all three new h2 sections, no broken markup.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A 🎹 OMNI button (sibling of 🎛 tracks, key O) opens a floating panel — the
planet's synth, laid out like a synth. NO new audio paths: a view over the same
dests + tweaks the field already drives.
- knobs: each knob's ARC is the dest's live value (n.normDisp, the same number
the field meters — it breathes with the world); dragging rides that dest's
tweak OFFSET (setParamLocal) and a dot marks your hand; double-click resets to
neutral; right-click opens the node's full context menu. Note voices (lead/bass)
show a live pitch arc — display-only (their character is the engine selector).
- modules: VOICES (lead/bass/pad/drone/perc), FX RACK (filter/reverb/delay/
saturation/glitch/granular/crush/morph/lfo/space), 🌀 EARTH ECHO (a toggle;
its six echo.* knobs appear only when it's on).
- header: voice-engine selector (FM tine / 🎸 string / 🎛 GODSONIQ — the pluck's
character, via Synth.stringVoice/godsoniq/sampling), ♪ start-stop, live BPM,
🔒 godtime lock.
Matrix honesty fix (computeDests): a hand-set positive offset now gives a voice a
floor even with no cable — so an OMNI (or the existing 'trim') knob can make a
voice audible from nothing. Only affects dests a user explicitly offset; a clean
instrument (all offsets 0) is bit-identical to before.
Verified live (z0test, via a manual matrix pump since the headless preview's rAF
is paused): panel opens with 21 knobs + 3 modules; idle arcs track live data
(filter 0.41); dragging reverb up floored its value 0.09→0.59 with the tweak dot
showing; double-click reset it; engine selector swapped FM→string; earth-echo
toggle revealed its knobs; right-click opened the 'filter cutoff' node menu.
Tweaks persist in the saved dimension (serializePatch carries tweaks). Console
clean, syntax clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A dimension is everything (the whole scene: routes, tweaks, grooves, tempo);
a vibe is a feeling you can hand a friend. Same /api/presets storage — this is
a framing rename, existing saves appear unchanged.
- ⚙ panel: 'MY PATCHES' → 'DIMENSIONS', copy reworked; input placeholder
'name this dimension…'.
- the load dropdown always leads with '✦ dimension zero — the empty field';
loading it calls enterZero() (the place you build from nothing).
- grimoire 'Saving your instrument' rewritten (canon = truth): the dimension /
vibe distinction, the GSV1 share code + #vibe= link, 'build a vibe, save a
vibe, share a vibe'.
Verified live (z0test): panel shows DIMENSIONS + ✨ VIBES, MY PATCHES gone,
dropdown leads with dimension zero. Console clean, syntax clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A vibe = a small bundle of cables {v:1,name,emoji,routes[≤32]}. Distinct from a
dimension (the whole scene): a vibe is a feeling you can hand a friend.
- apply is additive + reversible: routes a vibe creates are tagged (route._vibes)
so toggling it off removes exactly those; a route two vibes share survives until
both are off; a hand-built cable (route._base) a vibe merely rides is NEVER
deleted. Tags live in-memory only — they don't leak into saved patches.
- save from a zero orb (right-click → 💾), from any node's right-click in the full
field (💾 save these as a vibe), or 'save current wiring' in the panel (≤32 cap).
- ✨ vibes panel (zero pill + ⚙ gear): list, toggle on/off, ⧉ copy share code,
× delete, paste-to-import. localStorage library (gs_vibes).
- share: GSV1.<base64url(json)> clipboard code + godstrument.pro/#vibe=… fragment
that OFFERS on load (add it / just save) and never auto-applies.
- trust boundary: sanitizeVibe hard-validates every import — unknown source/dest
skipped (not thrown), amounts/roots/octaves clamped, curves/scales whitelisted,
32-route cap, try/catch the base64/JSON. Garbage codes are rejected cleanly.
- per-account cloud storage deferred: the code + local library already deliver
build/save/share across devices and friends. (add a vibes table if users ask.)
Verified live (z0test): built a 2-cable orb → saved 'sunrise duo' (quantize
preserved) → panel listed it ◉ → share code round-tripped through import →
garbage code rejected → hard-reload kept the library → toggle ON created exactly
2 routes (lead.note lit), toggle OFF removed them → #vibe= fragment offered
'shared gift' in the full app, hash cleared, not auto-applied. Console clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
C1: leaving zero with a build no longer silently discards it — a compact
three-way card (keep my build / bring the old world back / weave them
together); esc stays in zero. 0-route exits stay quiet (restore prezero).
C2: the zero build survives a reload — picks + cables persist to
gs_zeronodes/gs_zerobuild; enterZero(true) on the reload path restores them.
C3: tap-to-patch (arm an orb, tap a voice) as a touch fallback for drag;
right-click an orb → member list (× to drop a feed + its cables),
unpatch-this-orb, and a save-as-vibe stub (Z3); a ⛈ enter-the-storm pill.
Nit: the chakra-view key/menu is a no-op in zero (nothing to draw there).
Verified live (z0test): pick→orb→tap-patch lit lead.note; hard reload restored
the ☀ orb + lit socket; the exit card's keep-my-build landed in a healthy full
field on the storm mood with zero-storage cleared; orb menu drops members.
Console clean, syntax clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The functional heart — build the instrument by hand from zero.
- Orbs are draggable; the output-rack sockets are drop targets. Drop an orb on a
voice/FX socket → lays a cable per member feed (registerRoute), auto-adding a
default quantize (minor_pent / root 60 or 36 for bass) when the target is a
note voice. The socket lights green when it carries routes; a ticker line
confirms the patch and points to ♪.
- Right-click a socket → the "synth roll" assign menu: for note voices a scale
(the 11 SCALES) / root / octaves picker; for CC voices an amount slider + curve
picker (lin/exp/exp3/log/scurve/inv). Plus "× unpatch all". Edits the live routes.
- refreshSockets() reflects existing routes on open; hover-highlight on drag.
Z-AC verified live: pick sun.speed (cosmos ring) → drop on filter · pick
crypto.price (wealth ring) → drop on lead → both sockets light · right-click lead
→ scale picker (11 scales, root, octaves) · press ♪ → OMNI plays (button green).
Bitcoin sings through a sun-opened filter, built from nothing. Console clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Each built group becomes a spinning orb on the stage, not a flat chip — a glowing
core in the group's hue with its picked feeds as petals orbiting around it (CSS
zspin/zpulse). They accumulate as you build: pick from fire → one orb; add cosmos
→ two; and on. Orbs breathe live — the core glows by the group's average value,
each petal brightens with its own feed. More feeds widen the orbit ring.
Verified live: fire (3 petals) + cosmos (2 petals) render as two spinning glowing
orbs; console clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The overlay that replaces the sensory flood. In zero mode the node field is not
drawn (frame() skips drawCables/drawSourceNode/drawDestNode); a DOM overlay
takes its place over the starfield:
- 7 vibe-rings down each side — the 14 config groups (left = elements/feelings:
light·dark·fire·water·earth·air·spirit; right = domains: planet·cosmos·heavens·
human·market·wealth·summer). Each: a hued dot (GROUP_META — taste consts,
retune freely), label, live feed count, and a breathing glow scaled by the
group's live average value. Members come from groupsInfo (the hub's config).
- Picker drawer: click a ring → it slides in from that side listing the group's
feeds (name, key, live value bar, ⊕ that toggles in place). Pick 1+ → a stage
node (chip, colored by group) lands on the center stage.
- Output rack along the bottom: OMNI voices (lead·bass·pad·drone·perc) + space &
grit (filter·reverb·delay·…) as labeled sockets. Visual only — routing is Z2.
Veil (z-8) sits below the ♪/tracks/grimoire controls (z10-13) so they stay
usable. Verified live: rings render with hues + live glow, heavens drawer opens
with its 5 feeds + value bars, picking lands stage chips, ⊕ toggles in place,
console clean. Routing to the rack + right-click assign = Z2.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The calm front door. Zero is not a muted world (moods do that) — it's an EMPTY
one you build by hand, the same matrix started from nothing.
- enterZero(): snapshots the current patch → gs_prezero, then loadPatch({}) empties
the field; sets clientMatrix so the hub can't re-populate the cables; gs_mood="0 zero".
- exitZeroToMood(name): restores gs_prezero (the full factory) then applies the mood —
leaving zero brings the whole world back.
- First-visit choice card ("one world, three doors"): 🌱 start from zero · 🌅 first
light · ⛈ the full storm. Replaces the silent default-into-first-light; backdrop/esc =
first light. Returning users keep their last mood; a returning zero-user re-enters zero.
- Mood submenu gains "0 zero — build from nothing"; F11 toggles zero (KEY_ACTIONS).
Verified live (logged-in preview): card renders with 3 doors; "start from zero" empties
the field (56 factory cables cleared, snapshotted); F11 restores all 56 + first light
(92 BPM locked); returning-zero reload re-enters zero with no card; console clean.
The 7+7 calm slot UI is Z1. Not deployed yet (deploy is Z6, post-review).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Names the built-in browser synth OMNI (♪ tooltip, intro prose) and adds three
scannable "tech manual" reference sections to the grimoire — OMNI (full voice
roster + how-to), the Earth Echo (six world-driven tape knobs + Schumann), and
GODSONIQ (resample + tab feed) — each a numbered how-to plus a two-column
control/dest spec table (new .spec / ol.steps CSS; auto-indexed in the TOC).
Every label, dest key and world→voice mapping extracted from code and verified.
Fixes two drifted claims in the old Earth Echo prose the audit caught: tape
wear drives hiss only (grit/saturation is static, not world-driven), and the
Schumann sub is ×4 = two octaves (not "four times").
Manual: sections flow into PART I (extractor taught .spec/.row → markdown
bullets) + an OMNI umbrella entry in Appendix J.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Right-click sky → "🌐 feed a tab": getDisplayMedia({video:true, audio:{…}})
lets the user share another tab's audio (a YouTube tab, a stream). Wired via
createMediaStreamSource into preSat → the full FX chain + master, so it's
audible live, crush-able, and resampleable by GODSONIQ from one wiring. Video
track stopped immediately; a track 'ended' listener handles Stop-sharing.
Audio constraints (verified against MDN/W3C/Chrome docs): suppressLocalAudio
Playback so the tab isn't heard twice, and echoCancellation/noiseSuppression/
autoGainControl off so the WebRTC voice-DSP doesn't mangle music. Chromium-only
(feature-detected; graceful ticker hints for unsupported / no-audio-track);
macOS grabs a tab not all-system; DRM services capture silent, YouTube fine.
Grimoire (truth) + manual Appendix J updated.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Record ~3s of the live master mix into a buffer via a recorder AudioWorklet
tapping the full post-FX bus, then replay it pitched across the keyboard
(playbackRate = 2^((midi-60)/12), middle C = unity). Runs through the same
FX chain as every voice, so `crush` gives it the classic 12-bit sampler grit.
Right-click sky → 🎛 GODSONIQ to sample / re-sample; 🎸 string voice exits
back to the FM tine. Capture path verified: full-amplitude sawtooth recorded
clean (peak 0.98, rms 0.49) over the realtime port round-trip.
Grimoire (truth) + manual Appendix J updated.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The last two names that lied are now true:
- wavetable.morph — was a filter-Q sweep. Now a REAL wavetable: the lead is two
band-limited PeriodicWaves (a mellow one + a bright saw-rich one) crossfaded by
morph. Spectrally verified: smooth brightness sweep (centroid 462→880→1174
across morph 0→0.5→1), no aliasing.
- granular.density — was one occasional noise burst every 4th step. Now a REAL
grain cloud: a density-scaled scatter of short (12–40ms) pitch-varied grains
per step (0 at rest → a dense cloud when the world writes). noiseHit takes a
scheduled start time so grains scatter within the step.
The grimoire's existing claims ("sweeps the oscillator through its bank of
waveforms" / "a cloud of tiny grains") were aspirational — now they're accurate,
so no doc softening needed. Every clickable/routable thing now does what it says.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The two voices native Web Audio can't do safely, done as one AudioWorklet module
(loaded from a Blob URL, so still single-file):
- 🎸 Karplus-Strong string — a sample-accurate 8-voice plucked-string worklet
(noise burst → damped delay loop). Right-click sky → "string voice" swaps the
FM tine for it. Verified offline: STABLE (rms 0.04, not the billions the native
version exploded to), in-tune (A3→221, A4→436), harmonic.
- 🔊 12-bit bitcrush — a world-drivable lo-fi stage on the master bus (true
bit-depth quantise + sample-rate reduction). Route anything to `crush`; clean
by default (16-bit → 4-bit + downsample). Verified: transparent at 16-bit,
hi-freq grit 0.18 at 4-bit.
Loaded async on synth start, spliced glitch→crusher→out and karplus→preSat.
Verified live: both load with no errors, string-voice toggle flips correctly.
Grimoire + manual document the whole synth-voice suite.
This closes the timbre work: FM tine · supersaw · chorus · string · bitcrush —
every one tuned by the offline-render + FFT harness before it made a sound.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The whole visual now zooms: scroll or trackpad-pinch to zoom the canvas toward
the cursor (1×–6×), drag empty space to pan when zoomed, double-click to snap
home. Implemented as a CSS transform on #stage (smooth, no draw-loop surgery);
all four hit-test chokepoints (mousedown/move/up/contextmenu) invert the zoom so
clicking/dragging/right-clicking nodes still lands exactly — provably correct
(the inverse of the transform). Pan clamps so the canvas always covers the view.
Grimoire + manual note the gesture.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Supersaw: the pad's 3 chord tones each become a detuned saw cluster (9 saws,
±14¢ spread) — the lush JP-8000 wall. Verified offline: lush (133 partials),
no clip (peak 0.29), no aliasing, no DC; padAmp trimmed 0.10→0.07 for the extra
voices. Retuning loop + level updated for the new {o,iv} structure.
FM finish: bumped FM_RATIO 2→3 (the classic bright DX7 tine). Verified alias-free
across the whole register — even ratio 4 at A6/hard aliases <0.2% — so brightness
is pure taste, not a correctness risk. One-line const if you want warmer (2) or
glassier (4).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
pluck() (used by the sequencer, hand notes, and mind mode) is now a sine carrier
phase-modulated by a sine operator (ratio 2), with the mod index enveloped —
a bright "tine" attack decaying to a mellow tail — and scaled by velocity, so
harder = brighter (the DX7 magic). PM not FM, for stable pitch.
Built via the new spectral-verification method: rendered offline in an
OfflineAudioContext and FFT-analysed BEFORE shipping. Verified: in-tune
(A4→439Hz, A2→110Hz), harder-is-brighter (centroid 570→858), zero aliasing,
zero DC, stable. The harness earned its keep immediately — it caught a
Karplus-Strong feedback explosion (rms in the billions) that would've shipped
blind; KS + bitcrush deferred to an AudioWorklet batch (native feedback + filters
is unstable under Web Audio block-processing).
Taste (the FM ratio/index) is the one thing left for real ears. FM_RATIO is a
one-line const to tune.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The grimoire got big, so give it a proper entrance:
- ⚡ Quick-start card up top: a 7-step "make it sing in a minute" on-ramp for the
generative sequencer (scale → euclid → Play One → ratchet → p-lock → play).
- ☰ contents: a floating, jump-anywhere table of contents built from the 22 h2
sections (delta-based scroll so it lands reliably in any layout). Sits beside
the × close, drops a clean index panel, closes on pick or outside-click.
Verified: quick-start renders (7 steps), TOC lists all 22 sections and jumps
distinctly (Getting in→top, Playing it→far). Manual regenerated to match.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Replace the auto-derived skin scale (which gave 3× C wholetone and a sparse
hirajoshi default) with a curated SKIN_HOME map — a considered {root,scale} per
cosmology, every pair unique so turning the wheel always changes the key.
Verified: 14/14 distinct. Default (chakra) is now warm C minor pentatonic.
chakra C min-pent · planes A lydian · tree D minor · lodge G major ·
ladder E phrygian · yggdrasil F# minor · lataif B dorian · wuxing F# pentatonic ·
tarot A minor · zodiac C mixolydian · futhark G dorian · wheelyear F major ·
artist C wholetone · bagua E min-pent. (Fallback to derived scale for any future skin.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Steal the one clever idea from the PO/Elektron world: p-locks. A CC/texture
voice (filter, glitch, reverb, drive) now gets a per-step LOCK lane — pin its
value to a blocky level on any step, overriding the world there; drag a step
below the lane to unlock it and hand it back to the data. The filter jumping to
a different cutoff on every hit, disjointed and alive — a full groovebox.
- applyGroove(sq, step, world) unifies the gate + p-lock; computeDests calls it.
- lock[] rides on seqs (serialised, migrated). Note voices keep velocity/chance/
ratchet; CC voices get the p-lock lane (amber).
- self-check guards all four cases (no-groove / lit-unlocked / dark / locked).
- grimoire + manual updated (also documents the Juno chorus).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The safest, highest-value vintage borrow: an always-on subtle BBD-style chorus
on the master bus — two short delays each warbled by its own slow LFO, panned
wide, ~0.3 wet. Universally warms and widens the dry oscillators; can't sound
bad, can't error. Parallel send off `post`, chorusWet exposed for future
world-modulation. Verified: graph builds clean on synth start, no errors.
(FM mode, supersaw, and the 12-bit bitcrush are the next step — deferred to a
listening pass since they reshape core timbre and want real ears to tune, not
a backgrounded preview tab.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The flagship fix from the wired audit: skins were visual-only (the mix was
identical across all 14). Now the active Spirit re-tunes the Matter — each
skin's home tonality (its first station's scale) becomes the global scale, so
BOTH the sequencer and the ambient data-melodies re-harmonise when you turn the
wheel of cosmologies. Verified: 10 distinct tonalities across 14 skins
(chakra→B hirajoshi, wuxing→A dorian, wheelyear→F major, futhark→G# pentatonic…).
- skinHomeScale() derives {root,scale} from the skin's own station data (no
hardcoded map); applySkinScale() sets gScale on skin change + at init.
- computeDests overrides the ambient note quantize to follow gScale.
- the sequencer already followed gScale, so it re-tunes for free.
- grimoire updated: "choose your spirit and the same planet plays through it"
is now literally true. Manual regenerated.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Retire the wired-audit debt so nothing is decorative-pretending-to-be-wired:
- FREEZE now works: a group freeze snapshots each member and holds it (was a
set-but-never-read flag). Verified: holds 0.2 while the source moves to 0.9.
- .mid export is full-fidelity: real per-step velocity + ratchets expanded to
sub-notes (was hardcoded vel 100, single hits). Chance/Play-One stay live-only
— honest for a deterministic file.
- Hide the level/trim sliders on note voices (they never applied to a pitch —
no more dead sliders).
- Grimoire honesty: soften "every source is a real measurement" to name the
honest models (demographic tide, room-sensor sim); drop the phantom ⚙ SPELLS
panel claim. Manual regenerated to match.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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>
Global Scale (Live 12 Scale Awareness §3.13): a root + scale the whole groove
editor sings in. The piano-roll rows ARE the scale degrees (always folded to
scale), so every melody is in key; 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) and the
sequencer picks one at random each fire. Stack in-scale notes under a fast
Euclidean fill and the line glitches itself, always in key. Applied in both
grid editors, seqTick, and .mid export (prints the first candidate).
Self-check guards scaleRows + the stack helpers. Grimoire + manual in sync.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Live 12's Euclidean generator (manual §11.3.5) on the groove grid: spread N
pulses as evenly as possible over the pattern, with adjustable steps (cycle
length) and rotation, tiled into the 16-step grid. E(3,8) tresillo, E(5,8)
cinquillo, E(4,16) four-on-the-floor — one control fills any groove or gate
lane (note lanes fill the root). Verified live: E(4,16)→[0,4,8,12],
E(3,8)→[0,3,6,8,11,14], E(5,16)→[0,4,7,10,13]. Self-check guards the
canonical patterns. Grimoire + integrated manual updated to match.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Verified live: godstrument.pro is served from the botchat VPS
(humanjing@100.71.119.27) via Cloudflare Tunnel, NOT dealgod — corrected the
canon note and recorded the rsync+restart deploy recipe. Also track the
godstrument-verify / -test launch configs.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Rebuild GODSTRUMENT_MANUAL_SOURCE.md as a single finished grimoire, no drift:
- PART I is the current in-app grimoire (viz/index.html — the source of truth)
converted verbatim, so it now covers the Groove, follow actions, and every
feature the live prose does.
- Appendices A/C/D regenerated straight from config.json (83 sources, 56 cables,
14 vibes); B/E–J carried and refreshed, with the Groove / per-step expression /
follow actions added to the feature-systems appendix.
- dropped the old "brief for the manual writer (Gemini)" scaffolding — this
document IS the finished grimoire now, not a brief to write one.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Keep the source-of-truth grimoire honest — describe the swing/humanize/
velocity feel with presets, the per-step velocity & chance lanes, and the
⤳ follow-action clip hand-offs. (GODSTRUMENT_MANUAL_SOURCE.md mirror pending.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Ableton's Follow Actions (Live manual §16.7) on the arranger's clips: after a
clip plays its bar, it can hand off to another by chance — again / next / any /
any-other / stop — so an 8-bar loop stops being static. The manual's own words:
"structures that repeat but can also be surprising… never exactly repeat."
- per clip-letter action + chance, edited in the grooves tab.
- a live overlay (arr.now) diverts playback without rewriting the authored grid;
with no follow actions set, playback is byte-identical to before (no regression).
- ⤳ marks clips that can divert; the feel travels with the patch.
- self-check now guards the follow-action decision logic.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Ableton's Groove Pool (Live manual §14.1) reduced to the fixed 1/16 grid:
one "feel" applied to every playing pattern instead of scattered sliders.
- swing delays the off-beats; humanize = the manual's Random timing jitter;
velocity = per-note Velocity Deviation; amount = the Global Amount master.
- named presets: straight / swing 16 / mpc 8-4 / drunk.
- per-step Velocity + Chance editors on the grid (§10.5.11-13): each step
gets a loudness and a probability it fires.
- the feel + per-step expression travel with the patch; old patches migrate.
- gitignore the two large Live PDFs (local reference only).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Soccer, basketball, cricket (the long game), Australian football (the
winter Saturday roar at home), fighting, motorsport, ice hockey. Seven
calls per refresh — still ~2% of the free key's budget.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
TheSportsDB's free tier, invited with run.py --sports and off otherwise
(a shared, rate-limited key — 30/min — so the worker is polite by
design: the day's fixtures in a few calls per hour, everything else
computed at home). sport.events_today counts the planet's fixtures,
sport.inplay is the stadium lights climbing through the evenings, and
sport.kickoff fires the instant any match begins — swelling when many
kick off together. Routed where play belongs: Netzach the Victory,
Leo's fifth house of games, Lughnasadh's funeral games, wunjo the
joy-rune, dui the joyous lake.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
P (or F7) now removes everything that is not the world: the wordmark,
the header and its counts, the godtime readout, the ticker, every
button and chip. Only the visuals and the rotating dispatch line
remain for the audience. Z stays zen for the fully wordless sky.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Right-click any source: its actual number, live, with a two-minute
sparkline right in the menu — and 📌 pin it to the ticker, where your
watchlist scrolls ahead of the news with live values. The Binance tap
widens to ETH, SOL and the euro itself (EUR/USD on a 1s miniTicker,
since the pair trades thin), the ECB's daily fixes arrive as glacial
drones (GBP/USD, USD/JPY, AUD/USD), and Bitcoin speaks its own
technical analysis on 5s closes: the MACD line, Wilder's RSI(14), and
cross bells that ring once at every golden and death cross. All of it
routed through the Spirits like any money — to the solar plexus, to
Hod, to Nidavellir, to fehu.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The planet-ionosphere cavity rings at 7.83 Hz (Schumann, 1952), pumped
by every lightning strike on the globe. Below hearing, so it plays the
machine: a 7.83 Hz pulse forever breathing the Earth Echo's tone and
laying a planetary wow under the moon's — and octaved ×4 to 31.32 Hz,
a true sub humming beneath the drone voice. The one dial the world
never turns: it is the size of the Earth, and that does not change.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Eight trigrams in the King Wen Later Heaven ring, south at the top as
the compasses have it, every feed seated by the Shuogua's attributions:
quakes at zhen the thunder-shock, the word at dui the mouth, the moon
at kan, the sun at li, your own hands at gen — "Gen is the hand." At
the centre the two loudest trigrams stack into a live hexagram, named
from all 64 by the King Wen table; silence rests at 11, Peace.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Concerning the Spiritual in Art (1911) taken at its word: six pigments
round a wireframe palette, weiß the canvas on the easel, schwarz the
final pause, his four great contrasts strung dashed between the drops —
and every feed seated by the feeling of its colour, each colour keyed
to the register of its instrument. Paint strokes itself onto the canvas
as the data sings. Plus GODSTRUMENT_MANUAL_SOURCE.md (the manual's
source doc) and its Appendix E entry for the new skin.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The room as an instrument. Streams environmental sensors (light/temp/humidity/
pressure/ToF-hand/IMU-shake+tilt/mic-energy + crowd.hit events) to a hub over
OSC. Confirms + documents the hardware-agnostic ingest contract: OSC
/gs/<group>/<name> <float> -> a live source (already handled by hub._osc_handler;
send RAW, the hub auto-scales). Runs with zero sensors (smooth simulated
fallbacks) so the pipeline works before any hardware exists; real driver lines
(BH1750/BME280/VL53L1X/MPU6050/mic) are stubbed to uncomment.
Verified: --selfcheck passes; a live burst to the running hub created sources
room.*/hand.height/booth.*/crowd.* end-to-end over the websocket. Any SBC/lang
that speaks the OSC contract works identically — Pi4B ready today.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Capture-phase keydown runs bound actions (keymap wins over built-ins, skips
inputs and the mind-mode console). Defaults F1-F10: grimoire, play/stop,
skin view, next skin, cycle mood, tracks, performance, godtime lock, earth
echo, stage. Bind any key to any action from the ⌨ keys panel (sky menu), or
"map a key" in a voice's right-click menu — including targeted nudge-up /
nudge-down (a & s as a live fader on a drone) and mute/solo. keymap persists
(gs_keys); reset-to-defaults button. Synth.toggle() exposed for the play key.
Verified: F1 opens the grimoire, F5 cycles the mood (first light->ambient,
bpm->70 locked) — the engine and defaults fire; node-bind uses the same
capture flow. Zero console errors. Grimoire section added.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
A tape-delay effect in the built-in synth, RE-201 flavoured, with its knobs
exposed as matrix voices so any feed can drive them (and they groove/CV like
any voice). Audio chain: a delay with a feedback loop (lowpass tone roll +
highpass + tanh tape saturation), an LFO on delayTime for wow&flutter, and a
white-noise hiss bed for wear; the mix taps post -> echoIn -> wet -> out.
params() maps: echo.time -> delay 60-500ms with a LONG glide time-constant
(tape-motor pitch-bend), echo.feedback -> feedback HARD-CAPPED at 0.97
(self-oscillates, never runs away), echo.tone -> loop lowpass 6800->500Hz,
echo.flutter -> LFO depth, echo.wear -> hiss, echo.wet gated by earthEchoOn.
Sky menu "🌀 earth echo" toggles it (gs_echo persists); enabling installs the
earthy default cables: wind->time, volatility->feedback, air.pm25->tone,
moon->flutter, fire.count->wear, quake->wet. Verified: 6 echo voices appear in
the matrix with cables, zero console errors; param math unit-tested (feedback
capped, all ranges bounded, safe). Grimoire section added.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Two paths, both documented in the grimoire:
- MIDI-to-CV (already live, no new code): the note voices are 1V/oct pitch +
gate, CCs are modulation, 24ppqn clock is analog sync — any MIDI-CV module
(Befaco, CM1A, FH-2, Yarns) is driven today.
- NEW: true DC control voltage from Web Audio. Sky menu -> ⚡ control voltage.
A CV panel maps any source/voice to an output channel of a DC-coupled
interface (ES-8/ES-9) via ConstantSourceNode -> ChannelMerger -> multichannel
destination (setSinkId device pick). Modes: unipolar / bipolar / 1V-oct
(semitone-accurate), per-channel scale trim (real gear never tracks on
paper). Config persists (gs_cv). Output CLAMPED to +/-1 sample-units so it
can never send a runaway/damaging value.
Verified: voltage math unit-tested (monotonic, 1V/oct = 0.1/oct, clamped);
panel opens, device enumeration, channel add + persist, and the audio graph
starts cleanly (no exceptions). Physical voltage needs DC-coupled hardware to
confirm (documented). Zero console errors.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
applyMood now saves gs_mood; on page load the last-chosen mood re-applies
(default "first light"), guarded to run once per load (moodAppliedThisLoad),
never on a mid-session reconnect. A reload no longer drops you into the raw
factory "wall" — your vibe survives. Nothing mix-related survives a reload
anyway (routes/tweaks/grooves reset from the hub), so re-applying the mood is
strictly a friendlier landing. Plus: pressing the synth button into a
groove-less mix now tickers a hint pointing to mood -> first light.
Verified: first visit stores gs_mood=first light; reload re-applies it (dial
shows 92 LOCKED, gnarly voices muted), zero console errors.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- auth.py admin_stats now returns open_codes (all unclaimed invite codes,
newest first); unused_codes derived from it.
- account panel: renders every open code as a click-to-copy chip ("copied ✓"
flash); "issue new code" prepends the new code and auto-copies it. Chips are
user-selectable (the body-wide user-select:none no longer traps them).
copyText uses navigator.clipboard with an execCommand fallback for
non-secure contexts.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Replaces the cycle-through "skin: X ↺" item with a ctxSub listing every skin
by label, active one marked ✓ — no more clicking through 11 to reach the one
you want.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The source column packs ~68 feeds ~8px apart while each hit-target is 28px
wide, so the whole column is one continuous blur — you cannot aim one node,
and labels overlap unreadably. The loupe fixes it: hovering a dense column
unfolds a magnified strip of the ~9 nearest feeds, comfortably spaced and
fully labelled with live values, the one under the cursor highlighted. Each
row is a live hit target (click=mute, shift=tab, cmd=group, drag=patch);
the panel holds still while you reach across it. Right-click sky -> hover
zoom to toggle (localStorage gs_loupe).
Verified: activation on hover, correct render + position, hit-test lands the
right node, shift-clicking a magnified row opens that source's tab. Two bugs
found & fixed during review: the panel's activation band excluded the panel
itself (vanished as you reached for it -> panel-hold), and column identity was
by object reference which goes stale when doLayout rebuilds columnInfo (wrong
side/position -> track by stable "src"/"dst" side key). drawLoupe wrapped so a
draw error can never kill the render loop.
Also verified this session (no code change needed): drag source->voice creates
a cable; cmd-click multi-selects for grouping.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
