feat: possession presentation layer — glitchy text + degraded audio

First sub-project of the "make contact feel real" arc (spec:
docs/superpowers/specs/2026-07-23-possession-presentation-design.md).
Direct Contact replies now feel like a spirit fighting through static to
hold the channel rather than a plain chat bubble:

- backend/app/possession.py: compute_stability(rarity, magnitude, rng) —
  a 0.05-0.98 score per reply (rarer entity + stronger triggering anomaly =
  cleaner signal), rng injectable for a later quantum-RNG source.
- ws.py sends stability on reply_start; audio synthesis for that reply gets
  noise/bitcrush scaled by instability (1 - stability) via a new
  instability param on synthesize_spirit_voice — effects.py itself is
  untouched, only the params fed into it.
- frontend/src/lib/possession.ts: renderPossessedText — pure, deterministic
  (tick-seeded, no Math.random) text corruption with self-correcting
  glitch bursts, wired into Transcript.tsx's streaming reply display.

Stored transcript/reply text is unaffected — this is presentation only.
78/78 backend, 137/137 frontend tests passing.
This commit is contained in:
Indiana
2026-07-23 05:48:02 +00:00
parent bf8f352910
commit 58c30b7273
14 changed files with 638 additions and 21 deletions

View File

@@ -0,0 +1,69 @@
from app.possession import compute_stability
def test_rarity_ordering_holds_magnitude_and_rng_constant():
# Midpoint rng (0.5) zeroes out jitter, isolating the rarity base.
rng = lambda: 0.5
common = compute_stability("common", magnitude=50, rng=rng)
uncommon = compute_stability("uncommon", magnitude=50, rng=rng)
rare = compute_stability("rare", magnitude=50, rng=rng)
mythic = compute_stability("mythic", magnitude=50, rng=rng)
assert common < uncommon < rare < mythic
def test_unknown_rarity_falls_back_to_common_base():
rng = lambda: 0.5
assert compute_stability("legendary???", magnitude=50, rng=rng) == compute_stability(
"common", magnitude=50, rng=rng
)
def test_magnitude_bonus_increases_stability_up_to_cap():
rng = lambda: 0.5
low = compute_stability("common", magnitude=0, rng=rng)
mid = compute_stability("common", magnitude=10, rng=rng)
high = compute_stability("common", magnitude=1000, rng=rng)
assert low < mid < high
# Bonus caps at 0.15, so magnitude=15 and magnitude=1000 must land the
# same once base and jitter are held constant.
at_cap = compute_stability("common", magnitude=15, rng=rng)
past_cap = compute_stability("common", magnitude=1000, rng=rng)
assert at_cap == past_cap
def test_jitter_scaled_to_plus_minus_point_one():
# rng()=0 -> minimum jitter (-0.1); rng()=1 -> maximum jitter (+0.1).
base = 0.35 # common base
low_jitter = compute_stability("common", magnitude=0, rng=lambda: 0.0)
high_jitter = compute_stability("common", magnitude=0, rng=lambda: 1.0)
assert low_jitter == max(0.05, base - 0.1)
assert high_jitter == min(0.98, base + 0.1)
def test_clamped_at_lower_bound():
# common base 0.35 minus full jitter (0.1) minus nothing else is 0.25,
# comfortably above the floor -- force the floor with a negative-leaning
# setup instead: rarity base + jitter alone can't go below 0.05, but the
# clamp itself must still be exercised directly via a pathological rng.
stability = compute_stability("common", magnitude=0, rng=lambda: -100.0)
assert stability == 0.05
def test_clamped_at_upper_bound():
stability = compute_stability("mythic", magnitude=1000, rng=lambda: 100.0)
assert stability == 0.98
def test_deterministic_with_injected_rng():
rng = lambda: 0.73
first = compute_stability("rare", magnitude=42, rng=rng)
second = compute_stability("rare", magnitude=42, rng=rng)
assert first == second
def test_default_rng_produces_value_in_range():
stability = compute_stability("uncommon", magnitude=25)
assert 0.05 <= stability <= 0.98

View File

@@ -0,0 +1,118 @@
import pytest
import app.tts.piper as piper
from app.tts.voices import VOICES
@pytest.fixture(autouse=True)
def _fake_piper_synth(monkeypatch):
async def _fake_synthesize(self, text):
return b"fake-wav-bytes"
monkeypatch.setattr(piper.PiperTTS, "synthesize", _fake_synthesize)
def _capture_effects_call(monkeypatch):
calls = []
def _fake_apply_effects(wav_bytes, **kwargs):
calls.append(kwargs)
return wav_bytes
monkeypatch.setattr(piper, "apply_effects", _fake_apply_effects)
return calls
@pytest.mark.asyncio
async def test_zero_instability_keeps_profile_defaults(monkeypatch):
calls = _capture_effects_call(monkeypatch)
voice = VOICES["lessac"]
await piper.synthesize_spirit_voice("hello", voice, {"noise": 0.03, "bitcrush": 0})
assert calls[0]["noise_level"] == pytest.approx(0.03)
assert calls[0]["bitcrush_bits"] == 0
@pytest.mark.asyncio
async def test_instability_increases_noise_level(monkeypatch):
calls = _capture_effects_call(monkeypatch)
voice = VOICES["lessac"]
await piper.synthesize_spirit_voice(
"hello", voice, {"noise": 0.03, "bitcrush": 0}, instability=1.0
)
# Meaningfully louder than the clean baseline, but not blown out.
assert calls[0]["noise_level"] > 0.03
assert calls[0]["noise_level"] <= 0.1
@pytest.mark.asyncio
async def test_noise_level_scales_monotonically_with_instability(monkeypatch):
voice = VOICES["lessac"]
noise_levels = []
for instability in (0.0, 0.25, 0.5, 0.75, 1.0):
calls = _capture_effects_call(monkeypatch)
await piper.synthesize_spirit_voice(
"hello", voice, {"noise": 0.03, "bitcrush": 0}, instability=instability
)
noise_levels.append(calls[0]["noise_level"])
assert noise_levels == sorted(noise_levels)
assert noise_levels[0] < noise_levels[-1]
@pytest.mark.asyncio
async def test_bitcrush_stays_off_below_threshold(monkeypatch):
voice = VOICES["lessac"]
for instability in (0.0, 0.2, 0.5):
calls = _capture_effects_call(monkeypatch)
await piper.synthesize_spirit_voice(
"hello", voice, {"noise": 0.03, "bitcrush": 0}, instability=instability
)
assert calls[0]["bitcrush_bits"] == 0
@pytest.mark.asyncio
async def test_bitcrush_kicks_in_above_threshold(monkeypatch):
calls = _capture_effects_call(monkeypatch)
voice = VOICES["lessac"]
await piper.synthesize_spirit_voice(
"hello", voice, {"noise": 0.03, "bitcrush": 0}, instability=1.0
)
assert calls[0]["bitcrush_bits"] > 0
assert calls[0]["bitcrush_bits"] < 16
@pytest.mark.asyncio
async def test_instability_is_clamped_to_unit_range(monkeypatch):
calls = _capture_effects_call(monkeypatch)
voice = VOICES["lessac"]
await piper.synthesize_spirit_voice(
"hello", voice, {"noise": 0.03, "bitcrush": 0}, instability=5.0
)
clamped_high = calls[0]
calls = _capture_effects_call(monkeypatch)
await piper.synthesize_spirit_voice(
"hello", voice, {"noise": 0.03, "bitcrush": 0}, instability=1.0
)
at_one = calls[0]
assert clamped_high == at_one
@pytest.mark.asyncio
async def test_instability_adds_on_top_of_profile_bitcrush(monkeypatch):
calls = _capture_effects_call(monkeypatch)
voice = VOICES["lessac"]
await piper.synthesize_spirit_voice(
"hello", voice, {"noise": 0.03, "bitcrush": 4}, instability=1.0
)
assert calls[0]["bitcrush_bits"] > 4

View File

@@ -31,7 +31,7 @@ class FakeSpiritService:
return False
async def _fake_synth(text, voice, profile):
async def _fake_synth(text, voice, profile, instability=0.0):
return b"RIFFfake wav bytes"
@@ -124,7 +124,8 @@ async def test_question_streams_reply_and_records_history(sync_client, db_sessio
_read_until(ws, "session")
ws.send_json({"type": "question", "text": "Are you at peace?"})
_read_until(ws, "entity") # auto-summoned before answering
_read_until(ws, "reply_start")
reply_start = _read_until(ws, "reply_start")
assert 0.05 <= reply_start["stability"] <= 0.98
reply_end = _read_until(ws, "reply_end")
assert reply_end["text"] == "I am here."