drjones/qtalker---
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: the moon shapes who answers; wire magnetometer; drop dead CSS

Browse Source 
MOON INFLUENCE ON SUMMONING

Astronomy previously only decided whether a channel's familiar spirit
returned. It now shapes *who comes through*:

  - Rarity skews with real moon illumination. At full moon the rare and
    mythic weights roughly triple while common recedes, so a mythic
    summoning becomes a reason to go out on the right night rather than a
    flat lottery. Deliberately a skew and never a gate — every tier stays
    reachable on every night, because someone who can only play midweek
    should not be locked out of the good spirits.
  - Hidden traits take a small moonlit nudge: power and volatility rise,
    alignment drifts slightly darker. Capped at 0.12 and clamped to [0,1],
    so a full moon intensifies what a spirit already is instead of
    rewriting it. Deceptiveness is untouched — whether a spirit lies is its
    own nature, not the sky's doing.
  - The mint prompt is told the phase, and explicitly told the entity must
    never mention or seem aware of it. It shapes who they are, not their
    dialogue; a ghost remarking on the moonlight would break the illusion
    instantly.

Tests assert the outcomes shift in practice (mythic rate over 4000 draws,
rare-tier counts across 300 fallback profiles), not merely that the code
runs. test_mint_prompt_never_receives_traits now allows `sky` while still
forbidding `traits`: moon phase is public, observable state anyone can look
up, hidden ground truth is not.

GEOMAGNETIC (app/geomagnetic.py)

Real NOAA SWPC planetary K-index, verified against the live endpoint —
which caught a real bug: I had written the parser against an
array-of-arrays shape, and the actual feed serves a list of objects
(`estimated_kp` float, `kp_index` int, `kp` a display string with a letter
suffix). Fixed, and the tests now use the real captured shape. Cached,
never blocking, and a failed refresh keeps serving the last real value —
an hour-old genuine measurement beats nothing, and geomagnetic conditions
do not change fast enough for that to mislead.

MAGNETOMETER WIRED

MagnetometerListener existed but was never connected. The EMF panel now
runs it alongside the motion listener where the hardware exists, so the
"EMF meter" measures actual magnetic field in µT rather than only
inferring disturbance from movement. Additive: the motion path is
untouched and remains the only option on iOS. Its field jitter also feeds
the entropy pool.

DEAD CODE

Removed .evp-scope and .radio-waterfall, orphaned when both panels moved to
the shared SpectrumScope. Audited every other flagged export first and left
them alone — they are used internally, and "not imported elsewhere" is not
the same as dead.

Adds docs/CHANNELS.md recording what each channel measures and, honestly,
what has actually been verified against hardware versus only written
carefully.

311 backend + 355 frontend tests pass; i18n parity gate passes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Indiana
2026-07-28 13:31:15 +00:00
parent b8e69b4bd3
commit cf602ab3de
14 changed files with 1009 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

196
backend/app/entities.py
View File

@@ -8,7 +8,7 @@ import random
from app.entropy import veil_random
from app.models.entity import RARITY_TIERS
from app.tts.voices import EN_VOICE_IDS
from app.tts.voices import EN_VOICE_IDS, ES_VOICE_IDS
# An anomaly stream must show this much structure before it can fingerprint
# a spirit.
@@ -97,6 +97,117 @@ def parse_mint_response(text: str) -> dict | None:
return profile
# --- voice archetypes ------------------------------------------------------
#
# Rolling pitch/rate/noise/echo independently produces random *effects*, not
# distinct *people*: you get a uniform smear of slightly-odd voices that all
# sound like the same synthesizer wearing different hats. Real voices covary
# — an old man is low AND slow AND breathy; a child is high AND quick AND
# clean. So a throat is drawn as one coherent bundle, and only then jittered
# slightly, which is what makes two spirits sound like two different dead
# people rather than two settings.
#
# `voices` lists which Piper models suit the archetype (see tts/voices.py);
# ranges are (low, high) sampled uniformly.
VOICE_ARCHETYPES: tuple[dict, ...] = (
{
"key": "elder_man",
"voices": ("ryan", "alan", "hfc_male"),
# Deep, slow, and worn: age thins the voice and adds breath.
"pitch": (-8.5, -4.5),
"rate": (0.80, 0.90),
"noise": (0.045, 0.075),
"echo": (0.15, 0.30),
},
{
"key": "elder_woman",
"voices": ("lessac", "hfc_female"),
"pitch": (-3.0, 0.5),
"rate": (0.82, 0.92),
"noise": (0.040, 0.070),
"echo": (0.15, 0.30),
},
{
"key": "young_man",
"voices": ("ryan", "hfc_male"),
"pitch": (-2.0, 1.5),
"rate": (1.00, 1.12),
"noise": (0.015, 0.035),
"echo": (0.05, 0.18),
},
{
"key": "young_woman",
"voices": ("amy", "lessac"),
"pitch": (0.5, 4.0),
"rate": (1.00, 1.14),
"noise": (0.015, 0.035),
"echo": (0.05, 0.18),
},
{
"key": "child",
# Highest pitch and quickest delivery; a child's voice is also the
# cleanest, which is exactly what makes it unsettling through static.
"voices": ("amy", "lessac"),
"pitch": (6.0, 9.0),
"rate": (1.08, 1.20),
"noise": (0.010, 0.025),
"echo": (0.20, 0.38),
},
{
"key": "drowned",
# Waterlogged: pitched down, dragging, and very wet with echo.
"voices": ("hfc_female", "amy", "hfc_male"),
"pitch": (-6.0, -2.0),
"rate": (0.78, 0.88),
"noise": (0.055, 0.085),
"echo": (0.34, 0.50),
},
{
"key": "burned",
# Smoke-ruined throat: the noisiest archetype, barely holding pitch.
"voices": ("hfc_male", "hfc_female", "alan"),
"pitch": (-5.0, -1.0),
"rate": (0.84, 0.96),
"noise": (0.070, 0.100),
"echo": (0.10, 0.24),
},
{
"key": "distant",
# Far away rather than damaged — quiet, even, drenched in space.
"voices": ("lessac", "alan", "amy"),
"pitch": (-2.0, 2.0),
"rate": (0.88, 1.00),
"noise": (0.025, 0.045),
"echo": (0.40, 0.50),
},
)
def roll_voice(rng: random.Random, language: str = "en") -> dict:
"""Draw one coherent throat.
Spanish has only two installed models, so the archetype's voice list is
ignored there and the shaping alone carries the difference — better a
correctly-pronounced spirit with archetype shaping than an English
model mangling Spanish text.
"""
arch = rng.choice(VOICE_ARCHETYPES)
if language == "es":
voice_id = rng.choice(ES_VOICE_IDS)
else:
# Guard against an archetype naming a voice that isn't installed.
candidates = [v for v in arch["voices"] if v in EN_VOICE_IDS] or EN_VOICE_IDS
voice_id = rng.choice(candidates)
return {
"voice_id": voice_id,
"pitch": rng.uniform(*arch["pitch"]),
"rate": rng.uniform(*arch["rate"]),
"noise": rng.uniform(*arch["noise"]),
"echo": rng.uniform(*arch["echo"]),
"archetype": arch["key"],
}
def roll_traits(signature: str, entropy: object = None) -> dict:
"""Roll the four hidden truth-traits for an entity. These are never
derived from — or fed into — the LLM persona prompt (see `mint_prompt`,
@@ -144,6 +255,8 @@ def normalize_profile(profile: dict, signature: str, entropy: object = None) ->
visual = profile.get("visual") if isinstance(profile.get("visual"), dict) else {}
quotes = profile.get("quotes") if isinstance(profile.get("quotes"), list) else []
throat = roll_voice(rng, "es" if profile.get("_language") == "es" else "en")
rarity = str(profile.get("rarity", "common")).lower()
if rarity not in RARITY_TIERS:
rarity = "common"
@@ -163,14 +276,20 @@ def normalize_profile(profile: dict, signature: str, entropy: object = None) ->
"epithet": str(profile.get("epithet", rng.choice(_EPITHETS)))[:128],
"persona": str(profile.get("persona", ""))[:1200],
"rarity": rarity,
# A coherent throat, not four independent knobs — see roll_voice().
# The LLM may pin a voice_id and nudge parameters, but anything it
# leaves out (or gets wrong) falls back to the archetype's own
# covarying values rather than to a bland midpoint, so every spirit
# lands somewhere recognisably human.
"voice": {
"voice_id": voice.get("voice_id")
if voice.get("voice_id") in EN_VOICE_IDS + ["davefx", "ald"]
else rng.choice(EN_VOICE_IDS),
"pitch": _clamp(voice.get("pitch"), -6, 6, rng.uniform(-3, 3)),
"rate": _clamp(voice.get("rate"), 0.8, 1.15, rng.uniform(0.9, 1.05)),
"noise": _clamp(voice.get("noise"), 0.01, 0.08, rng.uniform(0.02, 0.05)),
"echo": _clamp(voice.get("echo"), 0.0, 0.5, rng.uniform(0.1, 0.3)),
if voice.get("voice_id") in EN_VOICE_IDS + ES_VOICE_IDS
else throat["voice_id"],
"pitch": _clamp(voice.get("pitch"), -9, 9, throat["pitch"]),
"rate": _clamp(voice.get("rate"), 0.75, 1.20, throat["rate"]),
"noise": _clamp(voice.get("noise"), 0.01, 0.10, throat["noise"]),
"echo": _clamp(voice.get("echo"), 0.0, 0.5, throat["echo"]),
"archetype": throat["archetype"],
},
"visual": {
"hue": _clamp(visual.get("hue"), 0, 360, rng.uniform(0, 360)),
@@ -182,7 +301,66 @@ def normalize_profile(profile: dict, signature: str, entropy: object = None) ->
}
def fallback_profile(signature: str, entropy: object = None) -> dict:
# Base rarity weights (common, uncommon, rare, mythic). The moon skews
# these: a dark sky keeps the ordinary dead ordinary, a full moon drags the
# distribution toward the strange. Real illumination drives it — see
# app/celestial.py, which computes actual phase rather than approximating a
# calendar.
BASE_RARITY_WEIGHTS = (55, 30, 12, 3)
def rarity_weights_for_moon(illumination: float | None) -> tuple[float, ...]:
"""Skew the rarity table by how much of the moon is lit.
At new moon the table is essentially the base one. At full moon the two
rare tiers roughly triple while common falls away, so a mythic
summoning stops being a lottery win and becomes a reason to go out on
the right night — which is the entire point of tracking the phase.
Deliberately a *skew*, never a gate: every tier stays reachable on
every night, because a seeker who can only play on a Tuesday should
never be locked out of the good spirits.
"""
if illumination is None:
return BASE_RARITY_WEIGHTS
lit = max(0.0, min(1.0, illumination))
common, uncommon, rare, mythic = BASE_RARITY_WEIGHTS
return (
common * (1.0 - 0.55 * lit),
uncommon * (1.0 + 0.10 * lit),
rare * (1.0 + 1.60 * lit),
mythic * (1.0 + 2.20 * lit),
)
def moon_trait_bias(traits: dict, illumination: float | None) -> dict:
"""Nudge hidden traits by moonlight.
Folklore is consistent that a full moon brings out what is strongest
and least stable, so power and volatility rise with illumination while
alignment drifts very slightly darker. Kept small (<=0.12) and clamped:
this is a thumb on the scale, not a rewrite — a benevolent spirit under
a full moon is still benevolent, just more so of whatever it already
was.
"""
if illumination is None:
return traits
lit = max(0.0, min(1.0, illumination))
def _clamp01(v: float) -> float:
return max(0.0, min(1.0, v))
return {
**traits,
"power": _clamp01(traits.get("power", 0.5) + 0.12 * lit),
"volatility": _clamp01(traits.get("volatility", 0.5) + 0.10 * lit),
"alignment": _clamp01(traits.get("alignment", 0.5) - 0.06 * lit),
}
def fallback_profile(
signature: str, entropy: object = None, illumination: float | None = None
) -> dict:
"""Procedural persona for when the LLM box is unreachable — a summoning
must never visibly fail.
@@ -198,7 +376,7 @@ def fallback_profile(signature: str, entropy: object = None) -> dict:
name = rng.choice(_NAME_PARTS[0]) + rng.choice(_NAME_PARTS[1])
epithet = rng.choice(_EPITHETS)
persona = rng.choice(_PERSONA_TEMPLATES).format(name=name)
rarity = rng.choices(RARITY_TIERS, weights=[55, 30, 12, 3])[0]
rarity = rng.choices(RARITY_TIERS, weights=rarity_weights_for_moon(illumination))[0]
return normalize_profile(
{
"name": name,