psyche-ai 7.1.0 → 9.0.0

package/dist/experiential-field.js

@@ -26,6 +26,45 @@ const CHEM_HIGH = 65;
 const CHEM_LOW = 35;
 /** If total activation is below this, the state is "flat/numb" */
 const FLATNESS_THRESHOLD = 0.15;
+// ── Affect Core (Russell Circumplex) ─────────────────────────
+/**
+ * Map chemistry to valence + arousal — the two fundamental affective dimensions
+ * (Russell's Circumplex Model of Affect, 1980).
+ *
+ * Valence: pleasure ↔ displeasure (-1 to 1)
+ * Arousal: activation level (0 to 1)
+ */
+export function computeAffectCore(chemistry) {
+    const { DA, HT, OT, END, CORT, NE } = chemistry;
+    // Valence: positive chemicals push up, stress pushes down
+    // CORT weighted 1.5× (cortisol is the dominant negative signal)
+    // NE weighted 0.5× (arousing but not inherently negative)
+    const rawValence = (DA - 50) + (HT - 50) + (OT - 50) + (END - 50) - (CORT - 50) * 1.5 - (NE - 50) * 0.5;
+    const valence = Math.max(-1, Math.min(1, rawValence / 250));
+    // Arousal: NE dominant, CORT and DA contribute
+    const rawArousal = NE + CORT * 0.5 + DA * 0.3;
+    const arousal = Math.max(0, Math.min(1, rawArousal / 180));
+    return { valence, arousal };
+}
+/**
+ * Each ExperientialQuality occupies a region in the Russell Circumplex.
+ * Matching = Euclidean distance from the concept center, within its radius.
+ * Context biases allow situational factors to pull toward specific concepts.
+ */
+const QUALITY_CONCEPTS = [
+    { quality: "flow", valenceCenter: 0.35, arousalCenter: 0.6, radius: 0.25, contextBiases: {} },
+    { quality: "contentment", valenceCenter: 0.4, arousalCenter: 0.2, radius: 0.25, contextBiases: { close: 0.1, deep: 0.15 } },
+    { quality: "yearning", valenceCenter: -0.2, arousalCenter: 0.4, radius: 0.3, contextBiases: { stranger: 0.1 } },
+    { quality: "vigilance", valenceCenter: -0.15, arousalCenter: 0.7, radius: 0.35, contextBiases: { sympathetic: 0.2 } },
+    { quality: "creative-surge", valenceCenter: 0.65, arousalCenter: 0.75, radius: 0.25, contextBiases: {} },
+    { quality: "wounded-retreat", valenceCenter: -0.5, arousalCenter: 0.3, radius: 0.25, contextBiases: { criticism: 0.2 } },
+    { quality: "warm-connection", valenceCenter: 0.45, arousalCenter: 0.35, radius: 0.25, contextBiases: { deep: 0.2, close: 0.15 } },
+    { quality: "restless-boredom", valenceCenter: -0.1, arousalCenter: 0.15, radius: 0.2, contextBiases: { boredom: 0.3 } },
+    { quality: "existential-unease", valenceCenter: -0.6, arousalCenter: 0.5, radius: 0.25, contextBiases: {} },
+    { quality: "playful-mischief", valenceCenter: 0.55, arousalCenter: 0.55, radius: 0.2, contextBiases: { humor: 0.2 } },
+    { quality: "conflicted", valenceCenter: 0.0, arousalCenter: 0.5, radius: 0.2, contextBiases: {} },
+    { quality: "numb", valenceCenter: 0.0, arousalCenter: 0.05, radius: 0.15, contextBiases: { "dorsal-vagal": 0.3 } },
+];
 // ── Main Export ──────────────────────────────────────────────
 /**
  * Compute the unified experiential field from the full psyche state.
@@ -34,12 +73,12 @@ const FLATNESS_THRESHOLD = 0.15;
  * relationship context, and optional metacognitive/bias data, then
  * synthesizes them into a single coherent experience description.
  */
-export function computeExperientialField(state, metacognition, decisionBias) {
+export function computeExperientialField(state, metacognition, decisionBias, context) {
     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 quality = constructQuality(state, coherence, intensity, rel, metacognition, context);
     const phenomenalDescription = generatePhenomenalDescription(quality, state, coherence, intensity, locale);
     const narrative = generateNarrative(quality, state, coherence, intensity, rel, locale, metacognition);
     return {
@@ -138,15 +177,18 @@ function computeIntensity(current, baseline) {
     // Map so that deviation of ~120 (avg 20 per chemical) = 0.5 intensity
     return clamp01(totalDeviation / 240);
 }
-// ── Quality Selection ────────────────────────────────────────
+// ── Quality Construction (Barrett's Constructed Emotion) ─────
 /**
- * Select the dominant experiential quality based on the full state pattern.
+ * Construct the dominant experiential quality using Barrett's theory:
+ *   1. Chemistry → valence + arousal (Russell Circumplex)
+ *   2. Concept matching: find closest quality in affective space
+ *   3. Context biases: autonomic state, stimulus, relationship, memories
  *
- * This is NOT just "what's the highest chemical" — it considers the
- * interaction between chemistry, drives, relationship, and coherence.
+ * Special override states (numb, conflicted, existential-unease) are
+ * preserved as hard gates — these represent extreme conditions where
+ * the normal construction process doesn't apply.
  */
-function selectQuality(state, coherence, intensity, relationship, metacognition, decisionBias) {
-    const c = state.current;
+function constructQuality(state, coherence, intensity, relationship, metacognition, context) {
     const d = state.drives;
     // ── Special states first (override everything) ──
     // Numb: nothing is happening. All near baseline, low intensity.
@@ -161,130 +203,81 @@ function selectQuality(state, coherence, intensity, relationship, metacognition,
     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 ──
+    // ── Barrett Step 1: Chemistry → Affect Core ──
+    const { valence, arousal } = computeAffectCore(state.current);
+    // ── Barrett Step 2+3: Concept matching with context ──
+    const contextKeys = buildContextKeys(context, relationship);
     let bestQuality = "contentment";
-    let bestScore = -1;
-    for (const [q, s] of Object.entries(scores)) {
-        if (s > bestScore) {
-            bestScore = s;
-            bestQuality = q;
+    let bestScore = -Infinity;
+    for (const concept of QUALITY_CONCEPTS) {
+        // Skip special states — already handled above
+        if (concept.quality === "numb" || concept.quality === "conflicted"
+            || concept.quality === "existential-unease") {
+            continue;
+        }
+        // Euclidean distance in affective space
+        const dv = valence - concept.valenceCenter;
+        const da = arousal - concept.arousalCenter;
+        const distance = Math.sqrt(dv * dv + da * da);
+        // Score: inverse distance, normalized by radius (Gaussian-like decay)
+        let score = Math.max(0, 1 - distance / concept.radius);
+        // Context biases: each matching context key adds its bias
+        for (const key of contextKeys) {
+            if (concept.contextBiases[key] !== undefined) {
+                score += concept.contextBiases[key];
+            }
+        }
+        // Core memory bias (P11): if related memories match this quality's region, boost
+        if (context?.coreMemories && context.coreMemories.length > 0) {
+            const memoryResonance = computeMemoryResonance(context.coreMemories, concept.valenceCenter, concept.arousalCenter);
+            score += memoryResonance * 0.1;
+        }
+        // Prediction error: high error weakens the current concept (forces re-evaluation)
+        if (context?.predictionError !== undefined && context.predictionError > 0.3) {
+            score -= context.predictionError * 0.15;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestQuality = concept.quality;
         }
     }
-    // If no quality scored meaningfully, fall back to contentment or numb
-    if (bestScore < 0.2) {
+    // If no concept matched meaningfully, fall back
+    if (bestScore < 0.1) {
         return intensity < 0.2 ? "numb" : "contentment";
     }
     return bestQuality;
 }
+/**
+ * Build context keys for Barrett concept matching from available context signals.
+ */
+function buildContextKeys(context, relationship) {
+    const keys = [];
+    if (context?.autonomicState) {
+        keys.push(context.autonomicState); // "ventral-vagal", "sympathetic", "dorsal-vagal"
+    }
+    if (context?.stimulus) {
+        keys.push(context.stimulus); // "praise", "criticism", "humor", etc.
+    }
+    if (relationship?.phase) {
+        keys.push(relationship.phase); // "stranger", "acquaintance", "familiar", "close", "deep"
+    }
+    return keys;
+}
+/**
+ * Compute how much core memories resonate with a given affective region.
+ * Returns 0-1 where 1 = strong resonance (memories cluster near the concept center).
+ */
+function computeMemoryResonance(memories, targetValence, targetArousal) {
+    if (memories.length === 0)
+        return 0;
+    let totalResonance = 0;
+    for (const mem of memories) {
+        const { valence: mv, arousal: ma } = computeAffectCore(mem.chemistry);
+        const dist = Math.sqrt((mv - targetValence) ** 2 + (ma - targetArousal) ** 2);
+        totalResonance += Math.max(0, 1 - dist / 0.5); // resonance fades at distance 0.5
+    }
+    return Math.min(1, totalResonance / memories.length);
+}
 // ── Phenomenal Description ───────────────────────────────────
 /**
  * Generate the raw "what it feels like" phrase.

package/dist/index.d.ts

@@ -2,8 +2,8 @@ export { PsycheEngine } from "./core.js";
 export type { PsycheEngineConfig, ProcessInputResult, ProcessOutputResult, ProcessOutcomeResult } from "./core.js";
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
 export type { StorageAdapter } from "./storage.js";
-export type { PsycheState, MBTIType, Locale, StimulusType, ChemicalState, ChemicalSnapshot, SelfModel, RelationshipState, EmpathyEntry, EmotionPattern, DriveType, InnateDrives, LearningState, LearnedVectorAdjustment, PredictionRecord, OutcomeScore, OutcomeSignals, AttachmentStyle, AttachmentData, MetacognitiveState, RegulationRecord, DefensePatternRecord, RegulationStrategyType, DefenseMechanismType, PersonhoodState, PersistedCausalInsight, GrowthDirection, PersonalityTraits, PsycheMode, } from "./types.js";
-export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, } from "./types.js";
+export type { PsycheState, MBTIType, Locale, StimulusType, ChemicalState, ChemicalSnapshot, SelfModel, RelationshipState, EmpathyEntry, EmotionPattern, DriveType, InnateDrives, LearningState, LearnedVectorAdjustment, PredictionRecord, OutcomeScore, OutcomeSignals, AttachmentStyle, AttachmentData, MetacognitiveState, RegulationRecord, DefensePatternRecord, RegulationStrategyType, DefenseMechanismType, PersonhoodState, PersistedCausalInsight, GrowthDirection, PersonalityTraits, PsycheMode, PolicyModifiers, TraitDriftState, EnergyBudgets, } from "./types.js";
+export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, DEFAULT_TRAIT_DRIFT, DEFAULT_ENERGY_BUDGETS, } from "./types.js";
 export { computeSelfReflection, computeEmotionalTendency, buildSelfReflectionContext } from "./self-recognition.js";
 export type { SelfReflection } from "./self-recognition.js";
 export { PsycheInteraction } from "./interaction.js";
@@ -21,25 +21,26 @@ export { updateAttachment, computeSeparationEffect, computeReunionEffect, } from
 export type { SeparationEffect } from "./attachment.js";
 export { assessMetacognition, computeEmotionalConfidence, generateRegulationSuggestions, detectDefenseMechanisms, } from "./metacognition.js";
 export type { MetacognitiveAssessment, RegulationSuggestion, DetectedDefense } from "./metacognition.js";
-export { computeDecisionBias, computeAttentionWeights, computeExploreExploit, buildDecisionContext, } from "./decision-bias.js";
+export { computeDecisionBias, computeAttentionWeights, computeExploreExploit, buildDecisionContext, computePolicyModifiers, buildPolicyContext, } from "./decision-bias.js";
 export type { DecisionBiasVector, AttentionWeights } from "./decision-bias.js";
-export { computeExperientialField, computeCoherence, detectUnnamedEmotion } from "./experiential-field.js";
-export type { ExperientialField, ExperientialQuality } from "./experiential-field.js";
+export { computeExperientialField, computeCoherence, detectUnnamedEmotion, computeAffectCore } from "./experiential-field.js";
+export type { ExperientialField, ExperientialQuality, ConstructionContext } from "./experiential-field.js";
 export { computeGenerativeSelf, predictSelfReaction, detectInternalConflicts, buildIdentityNarrative } from "./generative-self.js";
 export type { GenerativeSelfModel, CausalInsight, SelfPrediction, GrowthArc, InternalConflict } from "./generative-self.js";
 export { updateSharedIntentionality, estimateOtherMood, buildSharedIntentionalityContext } from "./shared-intentionality.js";
 export type { SharedIntentionalityState, TheoryOfMindModel, JointAttentionTopic, GoalAlignment } from "./shared-intentionality.js";
 export { assessEthics, detectIntermittentReinforcement, detectDependencyRisk, buildEthicalContext, } from "./ethics.js";
 export type { EthicalAssessment, EthicalConcern, SelfProtectionAction } from "./ethics.js";
-export { computeAutonomicResult, computeAutonomicState, gateEmotions, getTransitionTime, describeAutonomicState } from "./autonomic.js";
+export { computeAutonomicResult, computeAutonomicState, computeProcessingDepth, gateEmotions, getTransitionTime, describeAutonomicState } from "./autonomic.js";
 export type { AutonomicState, AutonomicResult, AutonomicTransition } from "./autonomic.js";
-export { computeCircadianModulation, computeHomeostaticPressure, getCircadianPhase } from "./circadian.js";
+export { computeCircadianModulation, computeHomeostaticPressure, getCircadianPhase, computeEnergyDepletion, computeEnergyRecovery } from "./circadian.js";
 export type { CircadianPhase } from "./circadian.js";
 export { computePrimarySystems, computeSystemInteractions, gatePrimarySystemsByAutonomic, getDominantSystems, describeBehavioralTendencies, PRIMARY_SYSTEM_NAMES, } from "./primary-systems.js";
 export type { PrimarySystemName, PrimarySystemLevels, BehavioralTendency, DominantSystem, } from "./primary-systems.js";
+export { updateTraitDrift } from "./drives.js";
 export { classifyStimulus, getPrimaryStimulus, scoreSentiment, scoreEmoji } from "./classify.js";
 export { buildProtocolContext, buildDynamicContext, buildCompactContext, isNearBaseline, getNearBaselineThreshold } from "./prompt.js";
 export { describeEmotionalState, getExpressionHint, getBehaviorGuide, detectEmotions } from "./chemistry.js";
 export { getBaseline, getTemperament, getSensitivity, getDefaultSelfModel, traitsToBaseline, mbtiToTraits } from "./profiles.js";
-export { migrateToLatest, compressSession, parsePsycheUpdate } from "./psyche-file.js";
+export { migrateToLatest, compressSession, parsePsycheUpdate, computeSnapshotIntensity, computeSnapshotValence, consolidateHistory, retrieveRelatedMemories, } from "./psyche-file.js";
 export type { PsycheUpdateResult } from "./psyche-file.js";

package/dist/index.js

@@ -12,7 +12,7 @@
 export { PsycheEngine } from "./core.js";
 // Storage
 export { FileStorageAdapter, MemoryStorageAdapter } from "./storage.js";
-export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, } from "./types.js";
+export { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, DEFAULT_ATTACHMENT, DRIVE_KEYS, DRIVE_NAMES_ZH, DEFAULT_TRAIT_DRIFT, DEFAULT_ENERGY_BUDGETS, } from "./types.js";
 // Self-recognition
 export { computeSelfReflection, computeEmotionalTendency, buildSelfReflectionContext } from "./self-recognition.js";
 // Multi-agent interaction
@@ -31,10 +31,10 @@ export { predictNextStimulus, generateAnticipation, computeSurpriseEffect, compu
 export { updateAttachment, computeSeparationEffect, computeReunionEffect, } from "./attachment.js";
 // Metacognition (P5)
 export { assessMetacognition, computeEmotionalConfidence, generateRegulationSuggestions, detectDefenseMechanisms, } from "./metacognition.js";
-// Decision bias (P5)
-export { computeDecisionBias, computeAttentionWeights, computeExploreExploit, buildDecisionContext, } from "./decision-bias.js";
-// Experiential field (P6)
-export { computeExperientialField, computeCoherence, detectUnnamedEmotion } from "./experiential-field.js";
+// Decision bias (P5) + PolicyModifiers (v9)
+export { computeDecisionBias, computeAttentionWeights, computeExploreExploit, buildDecisionContext, computePolicyModifiers, buildPolicyContext, } from "./decision-bias.js";
+// Experiential field (P6 + P8 Barrett construction)
+export { computeExperientialField, computeCoherence, detectUnnamedEmotion, computeAffectCore } from "./experiential-field.js";
 // Generative self (P6)
 export { computeGenerativeSelf, predictSelfReaction, detectInternalConflicts, buildIdentityNarrative } from "./generative-self.js";
 // Shared intentionality (P6)
@@ -42,14 +42,17 @@ export { updateSharedIntentionality, estimateOtherMood, buildSharedIntentionalit
 // Emotional ethics (P6)
 export { assessEthics, detectIntermittentReinforcement, detectDependencyRisk, buildEthicalContext, } from "./ethics.js";
 // Autonomic nervous system (P7)
-export { computeAutonomicResult, computeAutonomicState, gateEmotions, getTransitionTime, describeAutonomicState } from "./autonomic.js";
+export { computeAutonomicResult, computeAutonomicState, computeProcessingDepth, gateEmotions, getTransitionTime, describeAutonomicState } from "./autonomic.js";
 // Circadian rhythms (P12)
-export { computeCircadianModulation, computeHomeostaticPressure, getCircadianPhase } from "./circadian.js";
+export { computeCircadianModulation, computeHomeostaticPressure, getCircadianPhase, computeEnergyDepletion, computeEnergyRecovery } from "./circadian.js";
 // Primary emotional systems — Panksepp (P9)
 export { computePrimarySystems, computeSystemInteractions, gatePrimarySystemsByAutonomic, getDominantSystems, describeBehavioralTendencies, PRIMARY_SYSTEM_NAMES, } from "./primary-systems.js";
 // Utilities — for custom adapter / advanced use
+// Trait drift (v9)
+export { updateTraitDrift } from "./drives.js";
+// Utilities — for custom adapter / advanced use
 export { classifyStimulus, getPrimaryStimulus, scoreSentiment, scoreEmoji } from "./classify.js";
 export { buildProtocolContext, buildDynamicContext, buildCompactContext, isNearBaseline, getNearBaselineThreshold } from "./prompt.js";
 export { describeEmotionalState, getExpressionHint, getBehaviorGuide, detectEmotions } from "./chemistry.js";
 export { getBaseline, getTemperament, getSensitivity, getDefaultSelfModel, traitsToBaseline, mbtiToTraits } from "./profiles.js";
-export { migrateToLatest, compressSession, parsePsycheUpdate } from "./psyche-file.js";
+export { migrateToLatest, compressSession, parsePsycheUpdate, computeSnapshotIntensity, computeSnapshotValence, consolidateHistory, retrieveRelatedMemories, } from "./psyche-file.js";

package/dist/prompt.d.ts

@@ -13,6 +13,7 @@ export declare function buildDynamicContext(state: PsycheState, userId?: string,
     experientialNarrative?: string;
     autonomicDescription?: string;
     primarySystemsDescription?: string;
+    policyContext?: string;
 }): string;
 /**
  * Build the static protocol injected as cacheable system context.
@@ -64,4 +65,5 @@ export declare function buildCompactContext(state: PsycheState, userId?: string,
     experientialNarrative?: string;
     autonomicDescription?: string;
     primarySystemsDescription?: string;
+    policyContext?: string;
 }): string;

package/dist/prompt.js

@@ -121,6 +121,9 @@ export function buildDynamicContext(state, userId, opts) {
         const psTitle = locale === "zh" ? "行为倾向" : "Behavioral Tendencies";
         parts.push("", `[${psTitle}] ${opts.primarySystemsDescription}`);
     }
+    if (opts?.policyContext) {
+        parts.push("", opts.policyContext);
+    }
     parts.push("", agencyReminder, sycophancyWarning, "", t("dynamic.update_reminder", locale));
     return parts.filter((l) => l !== undefined).join("\n");
 }
@@ -788,6 +791,10 @@ export function buildCompactContext(state, userId, opts) {
             ? `[行为倾向] ${opts.primarySystemsDescription}`
             : `[Tendencies] ${opts.primarySystemsDescription}`);
     }
+    // 9h. Policy context (v9)
+    if (opts?.policyContext) {
+        parts.push(opts.policyContext);
+    }
     // 10. Channel modifier — expression style per platform
     if (opts?.channelType) {
         const channelProfile = getChannelProfile(opts.channelType);

package/dist/psyche-file.d.ts

@@ -1,4 +1,4 @@
-import type { PsycheState, MBTIType, RelationshipState, Locale, StimulusType, ChemicalSnapshot } from "./types.js";
+import type { PsycheState, MBTIType, ChemicalState, RelationshipState, Locale, StimulusType, ChemicalSnapshot } from "./types.js";
 /** Minimal logger interface */
 export interface Logger {
     info: (msg: string) => void;
@@ -26,6 +26,26 @@ export declare function getRelationship(state: PsycheState, userId?: string): Re
  * Pure computation, no LLM calls.
  */
 export declare function compressSession(state: PsycheState, userId?: string): PsycheState;
+/**
+ * Compute snapshot intensity: how far current chemistry deviates from baseline.
+ * Returns 0-1 (0 = at baseline, 1 = maximum possible deviation).
+ */
+export declare function computeSnapshotIntensity(current: ChemicalState, baseline: ChemicalState): number;
+/**
+ * Compute emotional valence from chemistry.
+ * Returns -1 (negative) to 1 (positive).
+ */
+export declare function computeSnapshotValence(chemistry: ChemicalState): number;
+/**
+ * Consolidate emotional history: mark core memories, fade weak ones.
+ * Called at session end or when history overflows.
+ */
+export declare function consolidateHistory(snapshots: ChemicalSnapshot[], maxEntries?: number): ChemicalSnapshot[];
+/**
+ * Retrieve memories related to current chemistry and stimulus.
+ * Uses chemical similarity + stimulus matching + core memory bonus.
+ */
+export declare function retrieveRelatedMemories(history: ChemicalSnapshot[], currentChemistry: ChemicalState, stimulus: StimulusType | null, limit?: number): ChemicalSnapshot[];
 /**
  * Load psyche state from workspace. Auto-initializes if missing.
  * Handles v1→v2 migration transparently.

package/dist/psyche-file.js

@@ -7,7 +7,7 @@ import { join } from "node:path";
 import { CHEMICAL_KEYS, CHEMICAL_NAMES, CHEMICAL_NAMES_ZH, DEFAULT_RELATIONSHIP, DEFAULT_DRIVES, DEFAULT_LEARNING_STATE, DEFAULT_METACOGNITIVE_STATE, DEFAULT_PERSONHOOD_STATE, MAX_EMOTIONAL_HISTORY, MAX_RELATIONSHIP_MEMORY, } from "./types.js";
 import { getBaseline, getDefaultSelfModel, extractMBTI, getSensitivity, getTemperament } from "./profiles.js";
 import { applyDecay, detectEmotions } from "./chemistry.js";
-import { decayDrives, computeEffectiveBaseline } from "./drives.js";
+import { decayDrives, computeEffectiveBaseline, updateTraitDrift } from "./drives.js";
 import { t } from "./i18n.js";
 import { computeSelfReflection } from "./self-recognition.js";
 const STATE_FILE = "psyche-state.json";
@@ -144,11 +144,16 @@ export function pushSnapshot(state, stimulus) {
     const dominantEmotion = emotions.length > 0
         ? (state.meta.locale === "en" ? emotions[0].name : emotions[0].nameZh)
         : null;
+    // P11: Compute intensity and valence for memory consolidation
+    const intensity = computeSnapshotIntensity(state.current, state.baseline);
+    const valence = computeSnapshotValence(state.current);
     const snapshot = {
         chemistry: { ...state.current },
         stimulus,
         dominantEmotion,
         timestamp: new Date().toISOString(),
+        intensity,
+        valence,
     };
     const history = [...(state.emotionalHistory ?? []), snapshot];
     let updatedRelationships = state.relationships;
@@ -291,13 +296,118 @@ export function compressSession(state, userId) {
     }
     const updatedRel = { ...existing, memory };
     const updatedRelationships = { ...state.relationships, [relKey]: updatedRel };
-    // ── Clear history and return ──
+    // ── P11: Consolidate and keep only core memories ──
+    const consolidated = consolidateHistory(history, MAX_EMOTIONAL_HISTORY);
+    const coreMemories = consolidated.filter((s) => s.isCoreMemory);
+    // ── v9: Update trait drift from session patterns ──
+    const currentDrift = state.traitDrift ?? {
+        accumulators: { praiseExposure: 0, pressureExposure: 0, neglectExposure: 0, connectionExposure: 0, conflictExposure: 0 },
+        sessionCount: 0,
+        baselineDelta: {},
+        decayRateModifiers: {},
+        sensitivityModifiers: {},
+    };
+    const updatedDrift = updateTraitDrift(currentDrift, history, state.learning);
+    // ── Clear non-core history, preserve core memories ──
     return {
         ...state,
-        emotionalHistory: [],
+        emotionalHistory: coreMemories,
         relationships: updatedRelationships,
+        traitDrift: updatedDrift,
     };
 }
+// ── P11: Emotional Memory Consolidation (McGaugh/Squire) ────
+/**
+ * Compute snapshot intensity: how far current chemistry deviates from baseline.
+ * Returns 0-1 (0 = at baseline, 1 = maximum possible deviation).
+ */
+export function computeSnapshotIntensity(current, baseline) {
+    let totalDeviation = 0;
+    for (const key of CHEMICAL_KEYS) {
+        totalDeviation += Math.abs(current[key] - baseline[key]);
+    }
+    return Math.min(1, totalDeviation / 600);
+}
+/**
+ * Compute emotional valence from chemistry.
+ * Returns -1 (negative) to 1 (positive).
+ */
+export function computeSnapshotValence(chemistry) {
+    const raw = ((chemistry.DA - 50) + (chemistry.HT - 50) + (chemistry.OT - 50)
+        + (chemistry.END - 50) - (chemistry.CORT - 50) - (chemistry.NE - 50) * 0.3) / 250;
+    return Math.max(-1, Math.min(1, raw));
+}
+/** Minimum intensity threshold for a snapshot to be stored (P11) */
+const INTENSITY_STORE_THRESHOLD = 0.15;
+/** Core memory intensity threshold */
+const CORE_MEMORY_THRESHOLD = 0.6;
+/** Maximum core memories to keep */
+const MAX_CORE_MEMORIES = 5;
+/**
+ * Consolidate emotional history: mark core memories, fade weak ones.
+ * Called at session end or when history overflows.
+ */
+export function consolidateHistory(snapshots, maxEntries = MAX_EMOTIONAL_HISTORY) {
+    if (snapshots.length === 0)
+        return [];
+    // Mark core memories
+    const marked = snapshots.map((s) => ({
+        ...s,
+        isCoreMemory: s.isCoreMemory || (s.intensity !== undefined && s.intensity >= CORE_MEMORY_THRESHOLD),
+    }));
+    // Separate core and non-core
+    const core = marked.filter((s) => s.isCoreMemory);
+    const nonCore = marked.filter((s) => !s.isCoreMemory);
+    // Enforce core memory limit (always, not just when over maxEntries)
+    let keptCore = core;
+    if (core.length > MAX_CORE_MEMORIES) {
+        const sorted = [...core].sort((a, b) => (b.intensity ?? 0) - (a.intensity ?? 0));
+        keptCore = sorted.slice(0, MAX_CORE_MEMORIES);
+        // Demoted cores become non-core
+        const demoted = sorted.slice(MAX_CORE_MEMORIES).map((s) => ({ ...s, isCoreMemory: false }));
+        nonCore.push(...demoted);
+    }
+    // If within limits after core trimming, keep all
+    if (keptCore.length + nonCore.length <= maxEntries) {
+        return [...keptCore, ...nonCore]
+            .sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    }
+    // Fill remaining slots with non-core (highest intensity first)
+    const remainingSlots = maxEntries - keptCore.length;
+    const keptNonCore = [...nonCore]
+        .sort((a, b) => (b.intensity ?? 0) - (a.intensity ?? 0))
+        .slice(0, Math.max(0, remainingSlots));
+    // Merge and sort chronologically
+    return [...keptCore, ...keptNonCore]
+        .sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+}
+/**
+ * Retrieve memories related to current chemistry and stimulus.
+ * Uses chemical similarity + stimulus matching + core memory bonus.
+ */
+export function retrieveRelatedMemories(history, currentChemistry, stimulus, limit = 3) {
+    if (history.length === 0)
+        return [];
+    const scored = history.map((snap) => {
+        // Chemical similarity (Euclidean distance normalized)
+        let sumSqDiff = 0;
+        for (const key of CHEMICAL_KEYS) {
+            const diff = snap.chemistry[key] - currentChemistry[key];
+            sumSqDiff += diff * diff;
+        }
+        const maxDist = Math.sqrt(6) * 100; // theoretical max distance
+        const similarity = 1 - Math.sqrt(sumSqDiff) / maxDist;
+        // Stimulus match bonus
+        const stimulusBonus = (stimulus && snap.stimulus === stimulus) ? 0.2 : 0;
+        // Core memory bonus
+        const coreBonus = snap.isCoreMemory ? 0.1 : 0;
+        return { snap, score: similarity + stimulusBonus + coreBonus };
+    });
+    return scored
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit)
+        .map((s) => s.snap);
+}
 /**
  * Load psyche state from workspace. Auto-initializes if missing.
  * Handles v1→v2 migration transparently.