Growth pAInz · AI Roaster

[ OPERATOR MANUAL ]

v2.1 — Built from actual source code. Verified June 2026.

Entity names, field names, and gate logic reflect the live codebase — not intended behavior.

AI Roaster is a psychoacoustic music production engineering suite built for Growth pAInz. It connects human creative intent with Suno AI generation through a structured declared-intent → scan → roast → remix pipeline. The core problem it solves: Suno AI does not interpret lyrics or style prompts the way a human performer would. It collapses rhythms, ignores emotional staging, and hallucinates endings. AI Roaster gives you a systematic way to override that — via phonetic engineering, syllable math, delta-aware scoring, and protocol-tracked iterative improvement.

▸ The Gate Logic (from DeclaredIntentForm.jsx)

Every scan starts here. The gate renders in one of four states: STATE 1 — PRIOR INTENT PICKER (new, added June 2026) Triggered when: a trackName is available (passed from Home via the trackName prop). What it does: queries the Analysis entity for records whose track_name fuzzy-matches the current track. Normalisation strips (Remastered), [v3], "remix", "v765" etc. before comparing — so "Taste" matches "Taste (Remastered) v765". Returns up to 50 records, filters to those with a declared_intent field populated, sorts newest-first. You pick one from the dated list. An explicit CONFIRM button must be clicked before the intent loads — it never auto-picks. "NONE OF THESE — DECLARE FRESH INTENT" drops you to the entry gate. STATE 2 — ENTRY GATE (IntentEntryGate.jsx) Two mode buttons: • DECLARE INTENT → launches IntentWizard (12-step guided flow) • RUN THE WASH → launches TheWash (blind scan — paste style spec + lyrics, system reads cold) Below both: a "manual form mode" link that skips to the raw form. STATE 3 — WIZARD / WASH IntentWizard: multi-step, persists draft to localStorage under key "intentWizard_draft". Guards against null sessionMode on state restore. Outputs a v2 declared_intent object. TheWash: outputs the same v2 schema. If it includes _lyrics, Home.handleIntentSubmit() pipes _lyrics into pendingLyrics state. STATE 4 — MANUAL FORM Direct field editing. All fields shown (see Intent Fields below). JSON import modal also available.

▸ Intent Fields (declared_intent v2 schema)

track_name — string, required before scan genre — string, required before scan subgenre — string, optional bpm — number (40–300) feel — enum: half-time | double-time | straight | swing | rubato | other. Default: half-time emotional_target — string (free text) emotional_stage — number | null (0–4+, null = not set) energy_type — enum: euphoric | tension-based | melancholic | kinetic | ambient. Default: kinetic vocal_style — string phonetic_system — boolean, default true → activates [PHONETIC_PROTECT] in LLM prompt arrangement_intent — string ending_type — enum: cold_stop | bridge_fade | chorus_out | loop | soft_dissolve. Default: cold_stop deviation_is_intentional — boolean, default true → activates [INTENTIONAL_ARCH] anti_dynamics_bias_override — boolean, default false → activates [NO_DYN_FLAGS] style_spec — string (full Suno style prompt) lock_notes — object | null (free-form keyed notes, displayed if present) _lyrics — internal-only field piped from TheWash into pendingLyrics

▸ After Intent Is Locked

Home stores the intent in sessionStorage under "home_declaredIntent". intentLocked flips to true. The upload layer appears: UploadZone, SunoLinkInput, RemixIntakePanel, LyricsInput, DataVault, LiveSessionsWidget. The "skip declared intent → go straight to upload (v1 mode)" link at the bottom bypasses the gate entirely by calling setIntentLocked(true) with no intent set — analysis still runs but with no declared intent context.