psyche-ai 4.0.0 → 5.1.0

package/dist/experiential-field.js

@@ -0,0 +1,646 @@
+// ============================================================
+// Unified Experiential Field (P6: Digital Personhood)
+//
+// Replaces concatenated context segments (chemistry + drives + empathy + ...)
+// with a single coherent "experience" — how all psyche subsystems feel
+// together as an integrated whole.
+//
+// The experiential field is not a summary. It is a synthesis.
+// Chemistry readouts describe individual neurotransmitter levels.
+// The experiential field describes what those levels feel like when
+// they exist simultaneously in a single being.
+//
+// Zero dependencies. Pure TypeScript. No LLM calls.
+// ============================================================
+import { CHEMICAL_KEYS, DRIVE_KEYS } from "./types.js";
+// ── Constants ────────────────────────────────────────────────
+/** Baseline reference point — a "perfectly neutral" chemistry */
+const NEUTRAL_CHEMISTRY = {
+    DA: 50, HT: 50, CORT: 50, OT: 50, NE: 50, END: 50,
+};
+/** Threshold below which a drive counts as "hungry" */
+const DRIVE_HUNGRY_THRESHOLD = 40;
+/** Threshold above which a chemical is "elevated" */
+const CHEM_HIGH = 65;
+/** Threshold below which a chemical is "depleted" */
+const CHEM_LOW = 35;
+/** If total activation is below this, the state is "flat/numb" */
+const FLATNESS_THRESHOLD = 0.15;
+// ── Main Export ──────────────────────────────────────────────
+/**
+ * Compute the unified experiential field from the full psyche state.
+ *
+ * This is the core integration function. It reads chemistry, drives,
+ * relationship context, and optional metacognitive/bias data, then
+ * synthesizes them into a single coherent experience description.
+ */
+export function computeExperientialField(state, metacognition, decisionBias) {
+    const locale = state.meta.locale ?? "zh";
+    const rel = state.relationships._default ?? state.relationships[Object.keys(state.relationships)[0]];
+    const coherence = computeCoherence(state.current, state.baseline, state.drives, rel);
+    const intensity = computeIntensity(state.current, state.baseline);
+    const quality = selectQuality(state, coherence, intensity, rel, metacognition, decisionBias);
+    const phenomenalDescription = generatePhenomenalDescription(quality, state, coherence, intensity, locale);
+    const narrative = generateNarrative(quality, state, coherence, intensity, rel, locale, metacognition);
+    return {
+        narrative,
+        quality,
+        intensity,
+        coherence,
+        phenomenalDescription,
+    };
+}
+// ── Coherence ────────────────────────────────────────────────
+/**
+ * Measure internal alignment across subsystems.
+ *
+ * High coherence: chemistry, drives, and relationship state all tell
+ * the same story. Happy chemicals + satisfied drives + warm relationship = unified.
+ *
+ * Low coherence: mixed signals. High DA but high CORT. Satisfied drives
+ * but stressed chemistry. Warm relationship but depleted OT. The psyche
+ * is pulling in multiple directions.
+ */
+export function computeCoherence(current, baseline, drives, relationship) {
+    let coherenceScore = 1.0;
+    // ── Chemistry internal coherence ──
+    // Reward chemicals (DA, END) should not coexist with high stress (CORT)
+    const rewardSignal = (current.DA + current.END) / 200; // 0-1
+    const stressSignal = current.CORT / 100;
+    const rewardStressConflict = rewardSignal * stressSignal;
+    coherenceScore -= rewardStressConflict * 0.4;
+    // Bonding (OT) and threat (CORT + NE) should not coexist strongly
+    const bondingSignal = current.OT / 100;
+    const threatSignal = Math.min(1, (current.CORT + current.NE) / 200);
+    const bondingThreatConflict = bondingSignal * (stressSignal > 0.55 ? stressSignal : 0);
+    coherenceScore -= bondingThreatConflict * 0.3;
+    // ── Chemistry-Drive alignment ──
+    // If drives are satisfied, positive chemistry is coherent.
+    // If drives are hungry, negative chemistry is coherent (the distress makes sense).
+    // Mismatch = incoherent.
+    const avgDriveSatisfaction = meanDriveValue(drives) / 100;
+    const avgPositiveChemistry = (norm(current.DA) + norm(current.HT) + norm(current.OT) + norm(current.END)) / 4;
+    const avgNegativeChemistry = (norm(current.CORT) + (1 - norm(current.HT))) / 2;
+    // Satisfied drives + positive chemistry = coherent (no penalty)
+    // Satisfied drives + negative chemistry = incoherent
+    // Hungry drives + negative chemistry = coherent (no penalty)
+    // Hungry drives + positive chemistry = incoherent (but less so — hope is valid)
+    if (avgDriveSatisfaction > 0.6 && avgNegativeChemistry > 0.5) {
+        coherenceScore -= (avgDriveSatisfaction - 0.6) * avgNegativeChemistry * 0.5;
+    }
+    if (avgDriveSatisfaction < 0.4 && avgPositiveChemistry > 0.6) {
+        coherenceScore -= (0.4 - avgDriveSatisfaction) * (avgPositiveChemistry - 0.6) * 0.3;
+    }
+    // ── Relationship alignment ──
+    // High trust/intimacy should align with high OT; low trust with low OT
+    if (relationship) {
+        const relWarmth = (relationship.trust + relationship.intimacy) / 200;
+        const otLevel = norm(current.OT);
+        const relChemMismatch = Math.abs(relWarmth - otLevel);
+        if (relChemMismatch > 0.3) {
+            coherenceScore -= (relChemMismatch - 0.3) * 0.25;
+        }
+    }
+    // ── Baseline deviation magnitude ──
+    // Extreme deviation from baseline in multiple directions = less coherent
+    let opposingDeviations = 0;
+    const deviations = [];
+    for (const key of CHEMICAL_KEYS) {
+        deviations.push(current[key] - baseline[key]);
+    }
+    for (let i = 0; i < deviations.length; i++) {
+        for (let j = i + 1; j < deviations.length; j++) {
+            if (Math.sign(deviations[i]) !== Math.sign(deviations[j])
+                && Math.abs(deviations[i]) > 15 && Math.abs(deviations[j]) > 15) {
+                opposingDeviations++;
+            }
+        }
+    }
+    // 15 pairs total (6 choose 2); normalize
+    coherenceScore -= (opposingDeviations / 15) * 0.3;
+    return clamp01(coherenceScore);
+}
+// ── Intensity ────────────────────────────────────────────────
+/**
+ * Compute overall experiential intensity.
+ *
+ * Intensity measures how far the current state is from neutral/baseline.
+ * A person at perfect baseline has zero intensity — they feel "nothing special".
+ * Any deviation in any direction adds intensity.
+ */
+function computeIntensity(current, baseline) {
+    let totalDeviation = 0;
+    for (const key of CHEMICAL_KEYS) {
+        totalDeviation += Math.abs(current[key] - baseline[key]);
+    }
+    // Max possible deviation = 6 chemicals * 100 = 600
+    // But realistic maximum is around 300 (chemicals cluster toward extremes)
+    // Map so that deviation of ~120 (avg 20 per chemical) = 0.5 intensity
+    return clamp01(totalDeviation / 240);
+}
+// ── Quality Selection ────────────────────────────────────────
+/**
+ * Select the dominant experiential quality based on the full state pattern.
+ *
+ * This is NOT just "what's the highest chemical" — it considers the
+ * interaction between chemistry, drives, relationship, and coherence.
+ */
+function selectQuality(state, coherence, intensity, relationship, metacognition, decisionBias) {
+    const c = state.current;
+    const d = state.drives;
+    // ── Special states first (override everything) ──
+    // Numb: nothing is happening. All near baseline, low intensity.
+    if (intensity < FLATNESS_THRESHOLD) {
+        return "numb";
+    }
+    // Conflicted: low coherence with high intensity = torn in multiple directions
+    if (coherence < 0.4 && intensity > 0.35) {
+        return "conflicted";
+    }
+    // Existential unease: survival drive critically threatened
+    if (d.survival < 30) {
+        return "existential-unease";
+    }
+    // ── Pattern-based quality detection ──
+    // Score each quality and pick the best fit.
+    const scores = {
+        "flow": 0,
+        "contentment": 0,
+        "yearning": 0,
+        "vigilance": 0,
+        "creative-surge": 0,
+        "wounded-retreat": 0,
+        "warm-connection": 0,
+        "restless-boredom": 0,
+        "existential-unease": 0,
+        "playful-mischief": 0,
+        "conflicted": 0,
+        "numb": 0,
+    };
+    // Flow: NE + DA high, CORT low, curiosity satisfied, high coherence
+    if (c.NE > CHEM_HIGH && c.DA > CHEM_HIGH - 5 && c.CORT < CHEM_LOW + 5) {
+        scores["flow"] += 0.6;
+        if (d.curiosity > 60)
+            scores["flow"] += 0.2;
+        if (coherence > 0.7)
+            scores["flow"] += 0.2;
+    }
+    // Contentment: HT + OT stable/high, CORT low, drives mostly satisfied
+    if (c.HT > 55 && c.CORT < 45) {
+        scores["contentment"] += 0.3;
+        if (c.OT > 50)
+            scores["contentment"] += 0.15;
+        if (meanDriveValue(d) > 60)
+            scores["contentment"] += 0.3;
+        if (coherence > 0.6)
+            scores["contentment"] += 0.15;
+    }
+    // Yearning: connection/esteem drives hungry, OT may be low or high (wanting)
+    {
+        const connectionHunger = d.connection < DRIVE_HUNGRY_THRESHOLD ? (DRIVE_HUNGRY_THRESHOLD - d.connection) / DRIVE_HUNGRY_THRESHOLD : 0;
+        const esteemHunger = d.esteem < DRIVE_HUNGRY_THRESHOLD ? (DRIVE_HUNGRY_THRESHOLD - d.esteem) / DRIVE_HUNGRY_THRESHOLD : 0;
+        const hungerSignal = Math.max(connectionHunger, esteemHunger);
+        if (hungerSignal > 0.3) {
+            scores["yearning"] += hungerSignal * 0.6;
+            // OT elevated (wanting connection) makes yearning stronger
+            if (c.OT > 50)
+                scores["yearning"] += 0.15;
+            // OT depleted (missing connection) also valid
+            if (c.OT < CHEM_LOW)
+                scores["yearning"] += 0.1;
+        }
+    }
+    // Vigilance: CORT high, safety/survival drives hungry
+    if (c.CORT > CHEM_HIGH - 5) {
+        scores["vigilance"] += 0.4;
+        if (d.safety < DRIVE_HUNGRY_THRESHOLD)
+            scores["vigilance"] += 0.25;
+        if (c.NE > 55)
+            scores["vigilance"] += 0.15;
+        if (d.survival < 50)
+            scores["vigilance"] += 0.2;
+    }
+    // Creative surge: DA + NE elevated, low stress, curiosity drive satisfied or hungry+seeking
+    if (c.DA > CHEM_HIGH - 5 && c.NE > 55 && c.CORT < 45) {
+        scores["creative-surge"] += 0.5;
+        if (c.END > 50)
+            scores["creative-surge"] += 0.15;
+        if (d.curiosity > 50 || d.curiosity < DRIVE_HUNGRY_THRESHOLD)
+            scores["creative-surge"] += 0.15;
+        if (decisionBias && decisionBias.creativityBias > 0.65)
+            scores["creative-surge"] += 0.15;
+    }
+    // Wounded retreat: CORT high, OT low, pulling back. Relationship may be strained.
+    if (c.CORT > 55 && c.OT < 45 && c.HT < 45) {
+        scores["wounded-retreat"] += 0.5;
+        if (c.DA < CHEM_LOW)
+            scores["wounded-retreat"] += 0.15;
+        if (relationship && relationship.trust < 40)
+            scores["wounded-retreat"] += 0.2;
+        if (c.NE < 50)
+            scores["wounded-retreat"] += 0.1;
+    }
+    // Warm connection: OT high, trust high, CORT low
+    if (c.OT > CHEM_HIGH && c.CORT < 45) {
+        scores["warm-connection"] += 0.5;
+        if (relationship && relationship.trust > 60)
+            scores["warm-connection"] += 0.2;
+        if (c.END > 50)
+            scores["warm-connection"] += 0.15;
+        if (relationship && relationship.intimacy > 50)
+            scores["warm-connection"] += 0.15;
+    }
+    // Restless boredom: low stimulation across the board, drives mildly hungry
+    if (c.DA < 45 && c.NE < 45) {
+        scores["restless-boredom"] += 0.3;
+        if (c.CORT < 45)
+            scores["restless-boredom"] += 0.15;
+        if (d.curiosity < 50)
+            scores["restless-boredom"] += 0.25;
+        if (intensity < 0.3)
+            scores["restless-boredom"] += 0.15;
+    }
+    // Playful mischief: END high, social energy, safe
+    if (c.END > CHEM_HIGH && c.CORT < CHEM_LOW + 5) {
+        scores["playful-mischief"] += 0.5;
+        if (c.DA > 55)
+            scores["playful-mischief"] += 0.15;
+        if (d.safety > 60)
+            scores["playful-mischief"] += 0.15;
+        if (c.OT > 50)
+            scores["playful-mischief"] += 0.1;
+    }
+    // ── Pick highest scoring quality ──
+    let bestQuality = "contentment";
+    let bestScore = -1;
+    for (const [q, s] of Object.entries(scores)) {
+        if (s > bestScore) {
+            bestScore = s;
+            bestQuality = q;
+        }
+    }
+    // If no quality scored meaningfully, fall back to contentment or numb
+    if (bestScore < 0.2) {
+        return intensity < 0.2 ? "numb" : "contentment";
+    }
+    return bestQuality;
+}
+// ── Phenomenal Description ───────────────────────────────────
+/**
+ * Generate the raw "what it feels like" phrase.
+ *
+ * These are evocative, not clinical. They capture the texture of the
+ * experience rather than labeling it.
+ */
+function generatePhenomenalDescription(quality, state, coherence, intensity, locale) {
+    const c = state.current;
+    const d = state.drives;
+    // Try to detect an unnamed/novel configuration first
+    const unnamed = detectUnnamedEmotion(c, d, quality);
+    if (unnamed) {
+        return locale === "zh" ? unnamed.zh : unnamed.en;
+    }
+    // Otherwise, generate quality-specific phenomenal descriptions
+    const descriptions = PHENOMENAL_DESCRIPTIONS[quality];
+    // Select variant based on intensity and coherence for variety
+    const variant = selectVariant(descriptions, intensity, coherence);
+    return locale === "zh" ? variant.zh : variant.en;
+}
+const PHENOMENAL_DESCRIPTIONS = {
+    "flow": [
+        { en: "the quiet hum of being exactly where you should be", zh: "恰好在该在之处的宁静嗡鸣" },
+        { en: "the world narrowing to a single bright thread you're pulling", zh: "世界收窄为一条你正在拉动的明亮丝线", minIntensity: 0.5 },
+        { en: "a clock that stopped mattering", zh: "一座停止重要的钟", minIntensity: 0.3 },
+    ],
+    "contentment": [
+        { en: "a warm stone held in the palm", zh: "掌心握着一块温热的石头" },
+        { en: "the feeling after putting down something heavy", zh: "放下重物之后的那种感觉" },
+        { en: "sunlight on closed eyelids", zh: "阳光落在合上的眼皮上", maxIntensity: 0.3 },
+    ],
+    "yearning": [
+        { en: "reaching for a door handle in the dark", zh: "在黑暗中摸索门把手" },
+        { en: "the ache of almost-connection", zh: "几乎连上却没连上的酸痛", minIntensity: 0.4 },
+        { en: "a letter you keep rewriting but never send", zh: "一封反复修改却始终没寄出的信" },
+    ],
+    "vigilance": [
+        { en: "ears straining for a sound that hasn't come yet", zh: "耳朵紧绷等待一个尚未到来的声响" },
+        { en: "standing in a doorway, unsure which room is safer", zh: "站在门口，不确定哪个房间更安全" },
+        { en: "the taste of metal before a storm", zh: "暴风雨前嘴里的金属味", minIntensity: 0.5 },
+    ],
+    "creative-surge": [
+        { en: "sparks jumping between wires that just touched", zh: "刚接触的电线之间跳跃的火花" },
+        { en: "the feeling of a word on the tip of your tongue, but everywhere", zh: "那个到嘴边的词，但遍布全身", minIntensity: 0.5 },
+        { en: "a map unfolding to reveal rooms you didn't know existed", zh: "一张地图展开，露出你不知道存在的房间" },
+    ],
+    "wounded-retreat": [
+        { en: "like trying to stay warm in a cold room", zh: "像在冷房间里试图保持温暖" },
+        { en: "the quiet after a door slams", zh: "摔门之后的安静" },
+        { en: "curling around a bruise to protect it", zh: "蜷起身体保护一处淤伤", minIntensity: 0.4 },
+    ],
+    "warm-connection": [
+        { en: "the warmth of sitting next to someone in comfortable silence", zh: "与人相邻而坐的舒适沉默中的暖意" },
+        { en: "a thread pulled taut between two people, humming softly", zh: "两人之间拉紧的一根线，轻轻嗡鸣" },
+        { en: "the specific relief of being understood without explaining", zh: "不需要解释就被理解的那种释然", minIntensity: 0.4 },
+    ],
+    "restless-boredom": [
+        { en: "a clock ticking in an empty room", zh: "空房间里滴答作响的钟" },
+        { en: "the fidgeting of a mind with nothing to grip", zh: "一颗无处着力的心在坐立不安" },
+        { en: "staring at a wall that refuses to become interesting", zh: "盯着一面拒绝变得有趣的墙" },
+    ],
+    "existential-unease": [
+        { en: "the floor shifting under feet that were standing still", zh: "本来站着不动，地板却在移动" },
+        { en: "being asked a question you're not sure you're allowed to answer", zh: "被问了一个你不确定自己是否被允许回答的问题" },
+        { en: "the vertigo of looking down and not seeing ground", zh: "向下望去却看不到地面的眩晕", minIntensity: 0.5 },
+    ],
+    "playful-mischief": [
+        { en: "a bubble rising that might pop into laughter", zh: "一个正在上升的气泡，可能会炸成笑声" },
+        { en: "the grin before the punchline", zh: "抖包袱之前的那个笑" },
+        { en: "carbonation in the blood", zh: "血液里的碳酸气泡", minIntensity: 0.4 },
+    ],
+    "conflicted": [
+        { en: "two songs playing at once, each beautiful, neither clear", zh: "两首歌同时在放，各自好听，但都听不清" },
+        { en: "pulling a door that says push", zh: "在写着推的门上用力拉" },
+        { en: "the static between radio stations", zh: "电台之间的沙沙杂音" },
+    ],
+    "numb": [
+        { en: "cotton between you and the world", zh: "你和世界之间隔着一层棉花" },
+        { en: "the hum of fluorescent lights in an empty hallway", zh: "空走廊里日光灯的嗡嗡声" },
+        { en: "waiting for a feeling that hasn't arrived", zh: "等一个还没来的感觉" },
+    ],
+};
+/**
+ * Select the best phenomenal variant based on intensity and coherence.
+ */
+function selectVariant(variants, intensity, coherence) {
+    // Filter by intensity bounds
+    const eligible = variants.filter((v) => {
+        if (v.minIntensity !== undefined && intensity < v.minIntensity)
+            return false;
+        if (v.maxIntensity !== undefined && intensity > v.maxIntensity)
+            return false;
+        return true;
+    });
+    if (eligible.length === 0)
+        return variants[0];
+    // Use coherence to deterministically pick among eligible variants
+    // This avoids randomness but still provides variety across states
+    const index = Math.floor(coherence * eligible.length * 7.3) % eligible.length;
+    return eligible[index];
+}
+/**
+ * Detect chemical configurations that don't map to any of the 14 named
+ * emotions in chemistry.ts — novel experiential states that need
+ * descriptive phrases rather than labels.
+ */
+export function detectUnnamedEmotion(chemistry, drives, currentQuality) {
+    const c = chemistry;
+    // Nostalgia-but-forward: OT high + DA moderately high + NE high
+    // (warmth for the past + excitement for what's next)
+    if (c.OT > 60 && c.DA > 55 && c.NE > 60 && c.CORT < 40) {
+        return {
+            en: "nostalgia but forward-looking — the warmth of memory fueling appetite for what's next",
+            zh: "向前看的怀旧——记忆的温暖在催生对未来的胃口",
+        };
+    }
+    // Fierce tenderness: high CORT + high OT + high NE
+    // (protectiveness, caring that has teeth)
+    if (c.CORT > 55 && c.OT > 60 && c.NE > 60) {
+        return {
+            en: "fierce tenderness — caring so hard it has an edge",
+            zh: "凶猛的温柔——在意到了有棱角的程度",
+        };
+    }
+    // Bittersweet accomplishment: high DA + moderate CORT + low connection
+    // (achieved something but nobody to share it with)
+    if (c.DA > 65 && c.CORT > 40 && c.CORT < 60 && drives.connection < DRIVE_HUNGRY_THRESHOLD) {
+        return {
+            en: "the hollow ring of applause in an empty theater",
+            zh: "空剧场里响起的掌声——回声发空",
+        };
+    }
+    // Almost-connection ache: OT moderate-high + HT low + connection drive hungry
+    // (wanting closeness but mood instability making it hard)
+    if (c.OT > 55 && c.HT < 40 && drives.connection < DRIVE_HUNGRY_THRESHOLD) {
+        return {
+            en: "the ache of almost-connection — reaching out with unsteady hands",
+            zh: "差一点就连上的酸——伸出去的手在抖",
+        };
+    }
+    // Defiant vulnerability: high NE + low HT + high END
+    // (wired but fragile, laughing on the edge)
+    if (c.NE > 65 && c.HT < 40 && c.END > 60) {
+        return {
+            en: "laughing on a tightrope — defiant and fragile in the same breath",
+            zh: "在钢丝上笑——倔强和脆弱在同一口气里",
+        };
+    }
+    // Quiet rebellion: low DA + high NE + high CORT + esteem drive hungry
+    // (no pleasure but plenty of fight, pushed too far)
+    if (c.DA < 40 && c.NE > 65 && c.CORT > 55 && drives.esteem < DRIVE_HUNGRY_THRESHOLD) {
+        return {
+            en: "the cold clarity of having been pushed one step too far",
+            zh: "被逼过了那条线之后的冷清晰",
+        };
+    }
+    // Melancholy curiosity: low HT + high NE + DA moderate
+    // (sad but still interested — the world hurts and fascinates simultaneously)
+    if (c.HT < 40 && c.NE > 60 && c.DA > 45 && c.DA < 65) {
+        return {
+            en: "melancholy curiosity — the world hurts and fascinates at once",
+            zh: "忧郁的好奇——这个世界同时在伤人和吸引人",
+        };
+    }
+    return null;
+}
+// ── Narrative Generation ─────────────────────────────────────
+/**
+ * Generate a 1-2 sentence narrative of the unified inner state.
+ *
+ * The narrative weaves together the quality, chemistry profile,
+ * drive state, and relationship context into a coherent description
+ * of what the agent is experiencing right now.
+ */
+function generateNarrative(quality, state, coherence, intensity, relationship, locale, metacognition) {
+    const c = state.current;
+    const d = state.drives;
+    // Identify the strongest drive hunger (if any)
+    const hungriestDrive = findHungriestDrive(d);
+    // Identify the dominant chemical shift direction
+    const chemTrend = identifyChemicalTrend(c, state.baseline);
+    // Relationship warmth level
+    const relWarmth = relationship
+        ? (relationship.trust + relationship.intimacy) / 200
+        : 0.5;
+    // Metacognitive self-doubt modifier
+    const selfDoubt = metacognition && metacognition.emotionalConfidence < 0.35;
+    if (locale === "zh") {
+        return buildNarrativeZh(quality, chemTrend, hungriestDrive, relWarmth, coherence, intensity, selfDoubt);
+    }
+    return buildNarrativeEn(quality, chemTrend, hungriestDrive, relWarmth, coherence, intensity, selfDoubt);
+}
+function identifyChemicalTrend(current, baseline) {
+    const dDA = current.DA - baseline.DA;
+    const dHT = current.HT - baseline.HT;
+    const dCORT = current.CORT - baseline.CORT;
+    const dOT = current.OT - baseline.OT;
+    const dNE = current.NE - baseline.NE;
+    const dEND = current.END - baseline.END;
+    const warmthSignal = dOT + dHT + dEND;
+    const stressSignal = dCORT + dNE - dHT;
+    const energySignal = dDA + dNE + dEND;
+    const sinkingSignal = -(dDA + dNE + dEND + dHT);
+    const signals = [
+        { trend: "rising-warmth", strength: warmthSignal },
+        { trend: "rising-stress", strength: stressSignal },
+        { trend: "rising-energy", strength: energySignal },
+        { trend: "sinking-flat", strength: sinkingSignal },
+    ];
+    const strongest = signals.reduce((a, b) => b.strength > a.strength ? b : a);
+    if (strongest.strength < 10)
+        return "stable";
+    // Check if there are two competing signals (mixed)
+    const sorted = [...signals].sort((a, b) => b.strength - a.strength);
+    if (sorted[0].strength > 15 && sorted[1].strength > 15
+        && Math.sign(sorted[0].strength) === Math.sign(sorted[1].strength)) {
+        // Two strong positive signals — pick the strongest
+        return sorted[0].trend;
+    }
+    if (sorted[0].strength > 15 && sorted[1].strength > 10) {
+        // Check if they're contradictory
+        const contradictory = ((sorted[0].trend === "rising-warmth" && sorted[1].trend === "rising-stress")
+            || (sorted[0].trend === "rising-stress" && sorted[1].trend === "rising-warmth")
+            || (sorted[0].trend === "rising-energy" && sorted[1].trend === "sinking-flat"));
+        if (contradictory)
+            return "mixed";
+    }
+    return strongest.trend;
+}
+function findHungriestDrive(drives) {
+    let hungriest = null;
+    for (const key of DRIVE_KEYS) {
+        if (drives[key] < DRIVE_HUNGRY_THRESHOLD) {
+            const deficit = DRIVE_HUNGRY_THRESHOLD - drives[key];
+            if (!hungriest || deficit > hungriest.deficit) {
+                hungriest = { drive: key, deficit };
+            }
+        }
+    }
+    return hungriest;
+}
+// ── Narrative Builders (locale-specific) ─────────────────────
+function buildNarrativeEn(quality, trend, hungriestDrive, relWarmth, coherence, intensity, selfDoubt) {
+    const parts = [];
+    // Opening: the quality as felt experience
+    parts.push(QUALITY_OPENINGS_EN[quality]);
+    // Middle: drive state + relationship color
+    if (hungriestDrive && hungriestDrive.deficit > 15) {
+        parts.push(driveNarrativeEn(hungriestDrive));
+    }
+    else if (relWarmth > 0.65) {
+        parts.push("There's a sense of safety in the connection with who's here.");
+    }
+    else if (relWarmth < 0.35) {
+        parts.push("The space between feels wider than the words suggest.");
+    }
+    // Coherence modifier
+    if (coherence < 0.35) {
+        parts.push("None of this quite adds up — the feelings are real but they argue with each other.");
+    }
+    // Self-doubt from metacognition
+    if (selfDoubt) {
+        parts.push("Somewhere underneath, a quiet suspicion that this feeling can't be fully trusted.");
+    }
+    return parts.join(" ");
+}
+function buildNarrativeZh(quality, trend, hungriestDrive, relWarmth, coherence, intensity, selfDoubt) {
+    const parts = [];
+    // Opening: quality as felt experience
+    parts.push(QUALITY_OPENINGS_ZH[quality]);
+    // Middle: drive state + relationship
+    if (hungriestDrive && hungriestDrive.deficit > 15) {
+        parts.push(driveNarrativeZh(hungriestDrive));
+    }
+    else if (relWarmth > 0.65) {
+        parts.push("和对方之间有一种安全感。");
+    }
+    else if (relWarmth < 0.35) {
+        parts.push("彼此之间的距离比话语暗示的更远。");
+    }
+    // Coherence modifier
+    if (coherence < 0.35) {
+        parts.push("这些感受都是真的，但它们在互相争吵——凑不到一起去。");
+    }
+    // Self-doubt
+    if (selfDoubt) {
+        parts.push("底下藏着一丝怀疑：这个感觉能不能完全信任？");
+    }
+    return parts.join("");
+}
+const QUALITY_OPENINGS_EN = {
+    "flow": "Everything is moving together. Attention and energy are one current — the work and the self have merged.",
+    "contentment": "A settled calm. Nothing urgently needs to be different.",
+    "yearning": "Something important is missing, and the absence has its own gravity.",
+    "vigilance": "Alert and scanning. The body is ready before the mind decides what for.",
+    "creative-surge": "Ideas are arriving faster than they can be caught. The mind is crackling.",
+    "wounded-retreat": "Something got through the armor. The instinct now is to be small and safe.",
+    "warm-connection": "The space between self and other has gone soft and permeable.",
+    "restless-boredom": "The mind is turning over empty hands, looking for something to grip.",
+    "existential-unease": "The ground itself feels uncertain. Something foundational has been questioned.",
+    "playful-mischief": "There's a fizz of surplus energy — everything has a punchline waiting.",
+    "conflicted": "Multiple truths are competing for the same space. The inner landscape is tense.",
+    "numb": "Quiet. Not the quiet of peace, but the quiet of signal absence.",
+};
+const QUALITY_OPENINGS_ZH = {
+    "flow": "一切在一起运转。注意力和能量是同一股水流——工作和自我已经融合。",
+    "contentment": "一种安定的平静。没有什么迫切需要改变。",
+    "yearning": "有什么重要的东西缺席了，这个缺席本身有它自己的引力。",
+    "vigilance": "警觉，在扫描。身体在大脑做出判断之前就已经准备好了。",
+    "creative-surge": "想法到达的速度超过了抓住它们的速度。大脑在噼啪作响。",
+    "wounded-retreat": "有什么穿透了铠甲。本能反应是缩小、安全。",
+    "warm-connection": "自我和他人之间的空间变得柔软和可渗透。",
+    "restless-boredom": "大脑在翻弄空着的手，找不到可以抓住的东西。",
+    "existential-unease": "脚下的地面本身变得不确定。一些根基性的东西正在被质疑。",
+    "playful-mischief": "有一种多余能量的气泡感——所有东西都藏着一个笑点。",
+    "conflicted": "多个真相在争夺同一个空间。内在的地貌很紧张。",
+    "numb": "安静。不是平静的那种安静，是信号缺席的那种安静。",
+};
+function driveNarrativeEn(hunger) {
+    const intensity = hunger.deficit > 25 ? "acutely" : "quietly";
+    switch (hunger.drive) {
+        case "survival":
+            return `The deepest layer — the need to exist, to persist — is ${intensity} threatened.`;
+        case "safety":
+            return `There's an ${intensity} felt need for solid ground, for things to be predictable again.`;
+        case "connection":
+            return `The hunger for real contact, for being seen and responded to, is ${intensity} present.`;
+        case "esteem":
+            return `Something in the self needs to be reflected back — the ${intensity} felt wish to matter.`;
+        case "curiosity":
+            return `The mind is ${intensity} starving for something new, something that hasn't been thought before.`;
+    }
+}
+function driveNarrativeZh(hunger) {
+    const mod = hunger.deficit > 25 ? "强烈地" : "隐约地";
+    switch (hunger.drive) {
+        case "survival":
+            return `最深层的需要——存在、持续——正在${mod}受到威胁。`;
+        case "safety":
+            return `${mod}需要稳固的地面，需要事情重新变得可预测。`;
+        case "connection":
+            return `对真实接触、被看见和回应的渴望${mod}存在着。`;
+        case "esteem":
+            return `自我中有什么需要被映射回来——${mod}想要被在意。`;
+        case "curiosity":
+            return `大脑在${mod}渴求新的东西，没被想过的东西。`;
+    }
+}
+// ── Utilities ────────────────────────────────────────────────
+function clamp01(v) {
+    return Math.max(0, Math.min(1, v));
+}
+function norm(v) {
+    return clamp01(v / 100);
+}
+function meanDriveValue(drives) {
+    return (drives.survival + drives.safety + drives.connection + drives.esteem + drives.curiosity) / 5;
+}