Introduce session profiles for Rhythma analysis

Add a session-profile layer to the analysis core so the redesign has a stable bridge between emotional input and the richer ambient renderer. This keeps the current text interpretation path intact while giving downstream UI and audio code a consistent session object to build from.

Constraint: Task 1 must stay scoped to analysis and tests only
Constraint: Explicit emotional keywords must keep precedence over focus-intent shortcuts
Rejected: Neutral fallback for unsupported emotions | created emotional_state/session_profile mismatches
Confidence: medium
Scope-risk: narrow
Reversibility: clean
Directive: Keep session_profile aligned with emotional_state for every supported state before expanding the renderer or UI
Tested: python -m py_compile rhythma_analysis.py tests/test_rhythma_profiles.py
Tested: PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python -c "import pytest; raise SystemExit(pytest.main(['tests/test_rhythma_profiles.py','-q','-p','no:cacheprovider']))"
Not-tested: Full app runtime or Gradio wiring; deferred to later tasks in the plan

rhythma_analysis.py

@@ -23,12 +23,33 @@ class AnalysisResult:
     emotional_state: str = "neutral"
     rhythm_pattern: str = "calm"
     transcription: str = ""
+    session_profile: dict | None = None
     error: str | None = None
 
     def to_dict(self):
         return asdict(self)
 
 
+@dataclass(frozen=True)
+class SessionProfile:
+    key: str
+    title: str
+    emotional_tone: str
+    tone_center: float
+    pattern: str
+    modulation_type: str
+    guidance: str
+    reflection: str
+    duration_hint: int
+    brightness: float
+    density: float
+    shimmer: float
+    breath_rate: float
+
+    def to_dict(self):
+        return asdict(self)
+
+
 def _cosine_similarity(left, right):
     denominator = np.linalg.norm(left) * np.linalg.norm(right)
     if denominator == 0:
@@ -36,6 +57,190 @@ def _cosine_similarity(left, right):
     return float(np.dot(left, right) / denominator)
 
 
+SESSION_PRESETS = {
+    "anxious": SessionProfile(
+        key="anxious",
+        title="Grounding Tide",
+        emotional_tone="Settling and steady",
+        tone_center=396.0,
+        pattern="calm",
+        modulation_type="sine",
+        guidance="Let your breath fall behind the pulse until the session feels steady.",
+        reflection="This session favors stability over intensity.",
+        duration_hint=15,
+        brightness=0.25,
+        density=0.45,
+        shimmer=0.12,
+        breath_rate=0.08,
+    ),
+    "stressed": SessionProfile(
+        key="stressed",
+        title="Soft Landing",
+        emotional_tone="Unwinding and spacious",
+        tone_center=417.0,
+        pattern="relaxed",
+        modulation_type="sine",
+        guidance="Let the longer exhale soften the edges of the session.",
+        reflection="This session eases pressure by widening the pulse.",
+        duration_hint=18,
+        brightness=0.22,
+        density=0.38,
+        shimmer=0.1,
+        breath_rate=0.07,
+    ),
+    "calm": SessionProfile(
+        key="calm",
+        title="Quiet Harbor",
+        emotional_tone="Easeful and settled",
+        tone_center=432.0,
+        pattern="calm",
+        modulation_type="sine",
+        guidance="Rest inside the repeating tone until it feels effortless.",
+        reflection="This session keeps motion light to support an even mood.",
+        duration_hint=15,
+        brightness=0.32,
+        density=0.28,
+        shimmer=0.11,
+        breath_rate=0.09,
+    ),
+    "sad": SessionProfile(
+        key="sad",
+        title="Low Ember",
+        emotional_tone="Tender and reflective",
+        tone_center=341.3,
+        pattern="relaxed",
+        modulation_type="sine",
+        guidance="Allow the lower tone to hold the feeling without forcing it to lift.",
+        reflection="This session gives weight and warmth to slower emotion.",
+        duration_hint=16,
+        brightness=0.18,
+        density=0.33,
+        shimmer=0.08,
+        breath_rate=0.07,
+    ),
+    "angry": SessionProfile(
+        key="angry",
+        title="Ember Release",
+        emotional_tone="Directed and discharging",
+        tone_center=528.0,
+        pattern="active",
+        modulation_type="pulse",
+        guidance="Track the sharper pulse until it turns from force into direction.",
+        reflection="This session channels intensity into movement rather than compression.",
+        duration_hint=12,
+        brightness=0.5,
+        density=0.62,
+        shimmer=0.16,
+        breath_rate=0.14,
+    ),
+    "fearful": SessionProfile(
+        key="fearful",
+        title="Shelter Light",
+        emotional_tone="Protected and steadying",
+        tone_center=384.0,
+        pattern="calm",
+        modulation_type="sine",
+        guidance="Stay with the nearest tone and let it make the room feel smaller and safer.",
+        reflection="This session reduces motion so attention can settle close to the body.",
+        duration_hint=14,
+        brightness=0.24,
+        density=0.31,
+        shimmer=0.09,
+        breath_rate=0.08,
+    ),
+    "confused": SessionProfile(
+        key="confused",
+        title="North Star",
+        emotional_tone="Clarifying and composed",
+        tone_center=480.0,
+        pattern="focused",
+        modulation_type="sine",
+        guidance="Follow one repeating detail until the rest of the field begins to organize.",
+        reflection="This session simplifies the soundstage to support orientation.",
+        duration_hint=14,
+        brightness=0.34,
+        density=0.3,
+        shimmer=0.13,
+        breath_rate=0.1,
+    ),
+    "happy": SessionProfile(
+        key="happy",
+        title="Bright Current",
+        emotional_tone="Open and buoyant",
+        tone_center=576.0,
+        pattern="active",
+        modulation_type="pulse",
+        guidance="Enjoy the lift in the rhythm without pushing it faster.",
+        reflection="This session keeps energy lively while protecting headroom.",
+        duration_hint=12,
+        brightness=0.56,
+        density=0.4,
+        shimmer=0.24,
+        breath_rate=0.15,
+    ),
+    "focused": SessionProfile(
+        key="focused",
+        title="Clear Horizon",
+        emotional_tone="Attentive and composed",
+        tone_center=512.0,
+        pattern="focused",
+        modulation_type="sine",
+        guidance="Stay with one thought and let the pulse keep the edges quiet.",
+        reflection="This session narrows motion to support sustained attention.",
+        duration_hint=20,
+        brightness=0.4,
+        density=0.35,
+        shimmer=0.18,
+        breath_rate=0.12,
+    ),
+    "relaxed": SessionProfile(
+        key="relaxed",
+        title="Open Meadow",
+        emotional_tone="Loose and restorative",
+        tone_center=444.0,
+        pattern="relaxed",
+        modulation_type="sine",
+        guidance="Let the slow sway in the session keep your attention unforced.",
+        reflection="This session favors softness and lingering resonance.",
+        duration_hint=18,
+        brightness=0.28,
+        density=0.26,
+        shimmer=0.12,
+        breath_rate=0.08,
+    ),
+    "active": SessionProfile(
+        key="active",
+        title="Kinetic Bloom",
+        emotional_tone="Motivated and rhythmic",
+        tone_center=648.0,
+        pattern="active",
+        modulation_type="pulse",
+        guidance="Let the pulse carry forward motion without turning rushed.",
+        reflection="This session keeps energy articulated and bright.",
+        duration_hint=10,
+        brightness=0.6,
+        density=0.48,
+        shimmer=0.2,
+        breath_rate=0.16,
+    ),
+    "neutral": SessionProfile(
+        key="neutral",
+        title="Still Current",
+        emotional_tone="Balanced and open",
+        tone_center=432.0,
+        pattern="calm",
+        modulation_type="sine",
+        guidance="Listen for the simplest pulse and let it set the pace.",
+        reflection="This session leaves space for your attention to settle naturally.",
+        duration_hint=12,
+        brightness=0.3,
+        density=0.3,
+        shimmer=0.1,
+        breath_rate=0.1,
+    ),
+}
+
+
 class RhythmaSymphAICore:
     """
     Interprets text and audio input to determine emotional state and rhythm pattern.
@@ -150,6 +355,9 @@ class RhythmaSymphAICore:
             if state in words or state in input_text_lower:
                 return state
 
+        if "focus" in input_text_lower or "deep work" in input_text_lower:
+            return "focused"
+
         self._ensure_embeddings_loaded()
         if self.embedding_model and self.emotional_embeddings:
             try:
@@ -198,6 +406,31 @@ class RhythmaSymphAICore:
 
         return "calm"
 
+    def build_session_profile(self, emotional_state, rhythm_pattern):
+        if emotional_state in SESSION_PRESETS:
+            preset = SESSION_PRESETS[emotional_state]
+        else:
+            preset = SESSION_PRESETS["neutral"]
+        profile = preset.to_dict()
+        profile["pattern"] = rhythm_pattern or preset.pattern
+        return profile
+
+    def apply_profile_overrides(
+        self,
+        profile,
+        tone_center=None,
+        modulation_type=None,
+        session_pattern=None,
+    ):
+        shaped_profile = dict(profile)
+        if tone_center is not None and tone_center > 0:
+            shaped_profile["tone_center"] = tone_center
+        if modulation_type:
+            shaped_profile["modulation_type"] = modulation_type
+        if session_pattern:
+            shaped_profile["pattern"] = session_pattern
+        return shaped_profile
+
     def transcribe_audio(self, audio_path):
         if not self.use_groq or not self.groq_client:
             return None, "Transcription disabled: Groq client not available or API key missing."
@@ -249,9 +482,14 @@ class RhythmaSymphAICore:
                 input_text=text_to_analyze,
                 emotional_state=result.emotional_state,
             )
+            result.session_profile = self.build_session_profile(
+                result.emotional_state,
+                result.rhythm_pattern,
+            )
         except Exception as exc:
             LOGGER.exception("Unexpected error during input analysis.")
             result = AnalysisResult(
+                session_profile=self.build_session_profile("neutral", "calm"),
                 transcription=result.transcription,
                 error=f"Unexpected error during input analysis: {exc}",
             )

tests/test_rhythma_profiles.py

@@ -0,0 +1,51 @@
+from rhythma_analysis import RhythmaSymphAICore
+
+
+def test_build_session_profile_for_anxious_text():
+    core = RhythmaSymphAICore(use_groq=False, use_embeddings=False)
+
+    result = core.analyze_input("I feel anxious and need to settle down")
+
+    assert result["emotional_state"] == "anxious"
+    assert result["session_profile"]["title"] == "Grounding Tide"
+    assert result["session_profile"]["pattern"] == "calm"
+    assert result["session_profile"]["modulation_type"] == "sine"
+    assert result["session_profile"]["guidance"].startswith("Let your breath")
+
+
+def test_apply_profile_overrides_keeps_session_shape():
+    core = RhythmaSymphAICore(use_groq=False, use_embeddings=False)
+
+    result = core.analyze_input("I want to focus on deep work")
+    profile = core.apply_profile_overrides(
+        result["session_profile"],
+        tone_center=512.0,
+        modulation_type="pulse",
+        session_pattern="focused",
+    )
+
+    assert profile["tone_center"] == 512.0
+    assert profile["modulation_type"] == "pulse"
+    assert profile["pattern"] == "focused"
+    assert profile["title"] == result["session_profile"]["title"]
+
+
+def test_build_session_profile_for_stressed_text():
+    core = RhythmaSymphAICore(use_groq=False, use_embeddings=False)
+
+    result = core.analyze_input("I feel stressed and overloaded")
+
+    assert result["emotional_state"] == "stressed"
+    assert result["session_profile"]["key"] == "stressed"
+    assert result["session_profile"]["title"] == "Soft Landing"
+    assert result["session_profile"]["pattern"] == "relaxed"
+
+
+def test_explicit_emotion_wins_over_focus_heuristic():
+    core = RhythmaSymphAICore(use_groq=False, use_embeddings=False)
+
+    result = core.analyze_input("I feel anxious and need to focus")
+
+    assert result["emotional_state"] == "anxious"
+    assert result["session_profile"]["key"] == "anxious"
+    assert result["session_profile"]["title"] == "Grounding Tide"