psyche-ai 10.2.3 → 11.2.0

package/dist/decision-bias.js

@@ -1,9 +1,10 @@
 // ============================================================
 // Decision Bias — P5: Decision Modulation
 //
-// Converts chemical state + drive state into bias vectors,
-// attention weights, and explore/exploit balance for downstream
-// decision-making. Pure math/heuristic, zero dependencies, no LLM.
+// Converts self-state dimensions (order/flow/boundary/resonance)
+// + drive state into bias vectors, attention weights, and
+// explore/exploit balance for downstream decision-making.
+// Pure math/heuristic, zero dependencies, no LLM.
 // ============================================================
 // ── Utilities ────────────────────────────────────────────────
 /** Clamp a value to [0, 1] */
@@ -14,7 +15,7 @@ function clamp01(v) {
 function sigmoid(x, steepness = 1) {
     return 1 / (1 + Math.exp(-steepness * x));
 }
-/** Normalize a 0-100 chemical/drive value to 0-1 */
+/** Normalize a 0-100 dimension/drive value to 0-1 */
 function norm(v) {
     return clamp01(v / 100);
 }
@@ -37,36 +38,36 @@ function meanDriveSatisfaction(drives) {
 /**
  * Compute a decision bias vector from the current psyche state.
  *
- * Each bias dimension is a weighted combination of relevant chemical
- * levels and drive states, normalized to [0, 1] where 0.5 is neutral.
+ * Each bias dimension is a weighted combination of relevant self-state
+ * dimensions and drive states, normalized to [0, 1] where 0.5 is neutral.
  */
 export function computeDecisionBias(state) {
     const c = state.current;
     const d = state.drives;
-    // explorationTendency: curiosity drive + DA (reward-seeking) + NE (novelty)
-    // High curiosity hunger (low satisfaction) + high DA/NE → explore
+    // explorationTendency: curiosity drive + flow (exchange/novelty-seeking)
+    // High curiosity hunger (low satisfaction) + high flow → explore
     const curiosityHunger = 1 - norm(d.curiosity); // lower satisfaction = more hunger
-    const explorationTendency = wavg([norm(c.DA), norm(c.NE), curiosityHunger, norm(d.curiosity)], [0.25, 0.3, 0.25, 0.2]);
-    // cautionLevel: CORT (stress) + safety drive hunger
-    // High CORT + low safety satisfaction → very cautious
+    const explorationTendency = wavg([norm(c.flow), curiosityHunger, norm(d.curiosity)], [0.4, 0.35, 0.25]);
+    // cautionLevel: low order (disorder/stress) + safety drive hunger
+    // Low order + low safety satisfaction → very cautious
+    const inverseOrder = 1 - norm(c.order);
     const safetyHunger = 1 - norm(d.safety);
     const survivalHunger = 1 - norm(d.survival);
-    const cautionLevel = wavg([norm(c.CORT), safetyHunger, survivalHunger], [0.5, 0.3, 0.2]);
-    // socialOrientation: OT (bonding) + connection drive satisfaction
-    // High OT + hungry for connection → strongly social
+    const cautionLevel = wavg([inverseOrder, safetyHunger, survivalHunger], [0.5, 0.3, 0.2]);
+    // socialOrientation: resonance (attunement) + connection drive
+    // High resonance + hungry for connection → strongly social
     const connectionHunger = 1 - norm(d.connection);
-    const socialOrientation = wavg([norm(c.OT), norm(d.connection), connectionHunger, norm(c.END)], [0.4, 0.2, 0.25, 0.15]);
-    // assertiveness: NE (arousal/confidence) + esteem drive satisfaction
-    // High NE + satisfied esteem → assertive
-    const assertiveness = wavg([norm(c.NE), norm(d.esteem), norm(c.DA)], [0.4, 0.35, 0.25]);
-    // creativityBias: DA (reward) + END (playfulness) + inverse CORT (low stress)
-    // Creativity flourishes when relaxed, rewarded, and playful
-    const inverseCort = 1 - norm(c.CORT);
-    const creativityBias = wavg([norm(c.DA), norm(c.END), inverseCort], [0.35, 0.3, 0.35]);
-    // persistenceBias: HT stability (serotonin) + overall drive satisfaction
-    // Stable mood + satisfied drives → willingness to persist
+    const socialOrientation = wavg([norm(c.resonance), norm(d.connection), connectionHunger], [0.45, 0.25, 0.3]);
+    // assertiveness: flow (activation) + boundary (self-clarity) + esteem drive
+    // High flow + clear boundary + satisfied esteem → assertive
+    const assertiveness = wavg([norm(c.flow), norm(c.boundary), norm(d.esteem)], [0.35, 0.3, 0.35]);
+    // creativityBias: flow (exchange/reward) + order (relaxed coherence)
+    // Creativity flourishes when flowing and internally coherent
+    const creativityBias = wavg([norm(c.flow), norm(c.order)], [0.55, 0.45]);
+    // persistenceBias: order (stability) + overall drive satisfaction
+    // Stable internal coherence + satisfied drives → willingness to persist
     const overallSatisfaction = meanDriveSatisfaction(d);
-    const persistenceBias = wavg([norm(c.HT), overallSatisfaction, inverseCort], [0.45, 0.35, 0.2]);
+    const persistenceBias = wavg([norm(c.order), overallSatisfaction], [0.55, 0.45]);
     return {
         explorationTendency,
         cautionLevel,
@@ -78,28 +79,29 @@ export function computeDecisionBias(state) {
 }
 /**
  * Compute attention weights that prioritize different conversation content
- * based on current chemical state.
+ * based on current self-state dimensions.
  *
  * Returns normalized weights (sum to ~1) for each content category.
  * Higher weight = higher priority for that type of content.
  */
 export function computeAttentionWeights(state) {
     const c = state.current;
-    // Raw scores based on chemical signatures
-    // High OT → prioritize relationship/social content
-    const socialRaw = norm(c.OT) * 0.6 + norm(c.END) * 0.2 + (1 - norm(c.CORT)) * 0.2;
-    // High NE → prioritize intellectual/novel content
-    const intellectualRaw = norm(c.NE) * 0.5 + norm(c.DA) * 0.3 + norm(state.drives.curiosity) * 0.2;
-    // High CORT → prioritize threat/safety content
-    const threatRaw = norm(c.CORT) * 0.6 + norm(c.NE) * 0.2 + (1 - norm(state.drives.safety)) * 0.2;
-    // Emotional content weighted by overall emotional activation
-    const emotionalRaw = (Math.abs(norm(c.DA) - 0.5)
-        + Math.abs(norm(c.HT) - 0.5)
-        + Math.abs(norm(c.CORT) - 0.5)
-        + Math.abs(norm(c.OT) - 0.5)) / 2; // average deviation from neutral, scaled
+    // Raw scores based on self-state dimension signatures
+    // High resonance → prioritize relationship/social content
+    const socialRaw = norm(c.resonance) * 0.6 + norm(c.order) * 0.2 + norm(c.flow) * 0.2;
+    // High flow → prioritize intellectual/novel content
+    const intellectualRaw = norm(c.flow) * 0.5 + norm(c.boundary) * 0.3 + norm(state.drives.curiosity) * 0.2;
+    // Low order (disorder/stress) → prioritize threat/safety content
+    const inverseOrder = 1 - norm(c.order);
+    const threatRaw = inverseOrder * 0.6 + norm(c.flow) * 0.2 + (1 - norm(state.drives.safety)) * 0.2;
+    // Emotional content weighted by overall dimensional activation
+    const emotionalRaw = (Math.abs(norm(c.order) - 0.5)
+        + Math.abs(norm(c.flow) - 0.5)
+        + Math.abs(norm(c.boundary) - 0.5)
+        + Math.abs(norm(c.resonance) - 0.5)) / 2; // average deviation from neutral, scaled
     // Routine content is inverse of activation — when calm and stable, routine matters
-    const activation = (norm(c.NE) + norm(c.CORT) + Math.abs(norm(c.DA) - 0.5)) / 3;
-    const routineRaw = Math.max(0.1, 1 - activation) * norm(c.HT);
+    const activation = (norm(c.flow) + inverseOrder + Math.abs(norm(c.resonance) - 0.5)) / 3;
+    const routineRaw = Math.max(0.1, 1 - activation) * norm(c.order);
     // Normalize to sum to 1
     const total = socialRaw + intellectualRaw + threatRaw + emotionalRaw + routineRaw;
     if (total <= 0) {
@@ -122,33 +124,31 @@ export function computeAttentionWeights(state) {
  *
  * Exploration is driven by:
  *   - High curiosity drive satisfaction (energy to explore)
- *   - High DA (reward anticipation)
- *   - High NE (novelty-seeking)
- *   - Low CORT (not stressed)
+ *   - High flow (exchange/novelty-seeking)
+ *   - High order (coherent enough to venture out)
  *   - High safety (secure enough to take risks)
  *
  * Exploitation is driven by:
- *   - High CORT / anxiety
+ *   - Low order (disorder/stress)
  *   - Low safety drive satisfaction
- *   - Low DA (no reward motivation)
+ *   - Low flow (no exchange motivation)
  */
 export function computeExploreExploit(state) {
     const c = state.current;
     const d = state.drives;
     // Exploration signals
     const curiosityEnergy = norm(d.curiosity);
-    const rewardDrive = norm(c.DA);
-    const noveltySeeking = norm(c.NE);
-    const relaxation = 1 - norm(c.CORT);
+    const flowDrive = norm(c.flow);
+    const coherence = norm(c.order);
     const securityBase = norm(d.safety);
     // Exploitation signals (inverted — higher = more exploit = lower explore)
-    const anxiety = norm(c.CORT);
+    const disorder = 1 - norm(c.order);
     const unsafety = 1 - norm(d.safety);
     const survivalThreat = 1 - norm(d.survival);
     // Weighted explore score
-    const exploreScore = wavg([curiosityEnergy, rewardDrive, noveltySeeking, relaxation, securityBase], [0.25, 0.2, 0.2, 0.2, 0.15]);
+    const exploreScore = wavg([curiosityEnergy, flowDrive, coherence, securityBase], [0.3, 0.25, 0.25, 0.2]);
     // Weighted exploit score
-    const exploitScore = wavg([anxiety, unsafety, survivalThreat], [0.5, 0.3, 0.2]);
+    const exploitScore = wavg([disorder, unsafety, survivalThreat], [0.5, 0.3, 0.2]);
     // Combine: use sigmoid to create a smooth transition
     // Positive difference → explore, negative → exploit
     const diff = exploreScore - exploitScore;
@@ -305,36 +305,36 @@ export function computePolicyModifiers(state) {
     let compliance = 0.6;
     let confirm = false;
     const avoid = [];
-    // ── Chemistry-driven adjustments ──
-    // High CORT → defensive: shorter, less compliant
-    if (c.CORT > 55) {
-        const cortPressure = (c.CORT - 55) / 45; // 0-1
-        lengthFactor -= cortPressure * 0.5;
-        compliance -= cortPressure * 0.35;
-        risk -= cortPressure * 0.35;
-    }
-    // Low HT → mood instability: less proactive, less risk-taking
-    if (c.HT < 45) {
-        const htDeficit = (45 - c.HT) / 45; // 0-1
-        proactivity -= htDeficit * 0.35;
-        risk -= htDeficit * 0.35;
-    }
-    // Low DA + low NE → burnout: shorter, passive
-    if (c.DA < 40 && c.NE < 40) {
-        const burnout = ((40 - c.DA) + (40 - c.NE)) / 80; // 0-1
+    // ── Dimension-driven adjustments ──
+    // Low order (disorder/stress) → defensive: shorter, less compliant
+    if (c.order < 45) {
+        const orderDeficit = (45 - c.order) / 45; // 0-1
+        lengthFactor -= orderDeficit * 0.5;
+        compliance -= orderDeficit * 0.35;
+        risk -= orderDeficit * 0.35;
+    }
+    // Low flow → stagnation: less proactive, less risk-taking
+    if (c.flow < 45) {
+        const flowDeficit = (45 - c.flow) / 45; // 0-1
+        proactivity -= flowDeficit * 0.35;
+        risk -= flowDeficit * 0.35;
+    }
+    // Low flow + low order → burnout: shorter, passive
+    if (c.flow < 40 && c.order < 40) {
+        const burnout = ((40 - c.flow) + (40 - c.order)) / 80; // 0-1
         lengthFactor -= burnout * 0.5;
         proactivity -= burnout * 0.45;
     }
-    // High DA + high HT → positive energy: more proactive, more open
-    if (c.DA > 60 && c.HT > 60) {
-        const energy = ((c.DA - 60) + (c.HT - 60)) / 80; // 0-1
+    // High flow + high order → positive energy: more proactive, more open
+    if (c.flow > 60 && c.order > 60) {
+        const energy = ((c.flow - 60) + (c.order - 60)) / 80; // 0-1
         proactivity += energy * 0.3;
         disclosure += energy * 0.2;
         risk += energy * 0.2;
     }
-    // High OT → bonding: more disclosure
-    if (c.OT > 60) {
-        const bondingSignal = (c.OT - 60) / 40; // 0-1
+    // High resonance → bonding: more disclosure
+    if (c.resonance > 60) {
+        const bondingSignal = (c.resonance - 60) / 40; // 0-1
         disclosure += bondingSignal * 0.3;
     }
     // ── Drive-driven adjustments ──

package/dist/demo.js

@@ -5,13 +5,13 @@
 // scenario in 6 rounds, with real PsycheEngine chemistry.
 //
 // Usage:
-//   npx psyche-mcp --demo
-//   npx psyche demo
+//   npx psyche-ai mcp --demo
+//   npx psyche-ai demo
 // ============================================================
 import { PsycheEngine } from "./core.js";
 import { MemoryStorageAdapter } from "./storage.js";
 import { detectEmotions } from "./chemistry.js";
-import { CHEMICAL_KEYS } from "./types.js";
+import { DIMENSION_KEYS } from "./types.js";
 // ── ANSI helpers ─────────────────────────────────────────────
 const C = {
     reset: "\x1b[0m",
@@ -128,7 +128,7 @@ function printLine(char = "─", width = 60) {
     process.stdout.write(c(C.dim, char.repeat(width)) + "\n");
 }
 function printChemistry(prev, curr, _locale) {
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const p = Math.round(prev[key]);
         const v = Math.round(curr[key]);
         const name = NT_NAMES[key];
@@ -259,7 +259,7 @@ export async function runDemo(opts) {
     process.stdout.write("\n");
     printLine("─");
     process.stdout.write(c(C.dim, "  Try it yourself: ") +
-        c(C.cyan, "npx psyche-mcp") +
+        c(C.cyan, "npx psyche-ai mcp") +
         c(C.dim, " (configure in Claude Desktop / Cursor / Claude Code)\n"));
     process.stdout.write(c(C.dim, "  npm: ") +
         c(C.cyan, "https://www.npmjs.com/package/psyche-ai") + "\n");

package/dist/diagnostics.d.ts

@@ -1,4 +1,4 @@
-import type { AppraisalAxes, PsycheState, ChemicalState, StimulusType, InnateDrives } from "./types.js";
+import type { AppraisalAxes, PsycheState, SelfState, StimulusType, InnateDrives } from "./types.js";
 /**
  * The four diagnostic layers, matching the frozen stack.
  * When something breaks, the first question is: which layer?
@@ -55,12 +55,12 @@ export interface DiagnosticReport {
     layerHealth: LayerHealthSummary;
     metrics: SessionMetrics;
     stateSnapshot: {
-        chemistry: ChemicalState;
-        baseline: ChemicalState;
+        current: SelfState;
+        baseline: SelfState;
         drives: InnateDrives;
         agreementStreak: number;
         totalInteractions: number;
-        emotionalHistoryLength: number;
+        stateHistoryLength: number;
         relationshipCount: number;
         stateVersion: number;
     };
@@ -108,11 +108,11 @@ export declare function runHealthCheck(state: PsycheState): DiagnosticIssue[];
 export declare function computeLayerHealthSummary(state: PsycheState, issues: DiagnosticIssue[]): LayerHealthSummary;
 export declare class DiagnosticCollector {
     private metrics;
-    private prevChemistry;
+    private prevState;
     private confidences;
     constructor();
     /** Record a processInput result */
-    recordInput(stimulus: StimulusType | null, confidence: number, chemistry: ChemicalState, appraisal?: AppraisalAxes): void;
+    recordInput(stimulus: StimulusType | null, confidence: number, chemistry: SelfState, appraisal?: AppraisalAxes): void;
     /** Record an error */
     recordError(phase: string, error: unknown): void;
     /** Get current session metrics */

package/dist/diagnostics.js

@@ -14,14 +14,14 @@
 //
 // Zero dependencies. Privacy-first — no message content logged.
 // ============================================================
-import { CHEMICAL_KEYS, DRIVE_KEYS } from "./types.js";
+import { DIMENSION_KEYS, DRIVE_KEYS } from "./types.js";
 import { detectEmotions } from "./chemistry.js";
 // ── Health Checks ────────────────────────────────────────────
 export function runHealthCheck(state) {
     const issues = [];
     // ── L1: Subjective Continuity ─────────────────────────────
     // 1. Chemistry out of bounds — clamp() missed somewhere
-    for (const key of CHEMICAL_KEYS) {
+    for (const key of DIMENSION_KEYS) {
         const val = state.current[key];
         if (val < 0 || val > 100) {
             issues.push({
@@ -30,7 +30,7 @@ export function runHealthCheck(state) {
                 severity: "critical",
                 message: `${key} out of bounds: ${val.toFixed(1)}`,
                 detail: `Expected 0-100, got ${val}`,
-                suggestion: `clamp() 没覆盖到某条路径。检查 chemistry.ts 里 apply${key === "CORT" ? "Stimulus" : "Contagion"} 和 drives.ts computeEffectiveBaseline 的计算链`,
+                suggestion: `clamp() 没覆盖到某条路径。检查 chemistry.ts 里 applyStimulus 和 drives.ts computeEffectiveBaseline 的计算链`,
             });
         }
     }
@@ -43,7 +43,7 @@ export function runHealthCheck(state) {
                 layer: "subjective-continuity",
                 severity: "critical",
                 message: `Drive '${key}' out of bounds: ${val.toFixed(1)}`,
-                suggestion: `drives.ts feedDrives/decayDrives 缺少边界检查`,
+                suggestion: `drives deriveDriveSatisfaction 返回值越界——检查维度值是否在 [0, 100]`,
             });
         }
     }
@@ -55,7 +55,7 @@ export function runHealthCheck(state) {
             layer: "subjective-continuity",
             severity: "warning",
             message: `${criticalDrives.length}/5 drives below 15: ${criticalDrives.join(", ")}`,
-            suggestion: `decayDrives 衰减太猛。考虑加一个下限（比如 10），或者在 initialize 时根据距上次对话时间做 recovery`,
+            suggestion: `维度衰减太猛导致 drives 全面坍塌。检查 baseline 和 decay 参数，或在 initialize 时根据距上次对话时间做 recovery`,
         });
     }
     // 4. Sycophancy — agent never disagrees
@@ -69,7 +69,7 @@ export function runHealthCheck(state) {
         });
     }
     // 5. Classifier dead/weak — the core experience problem
-    const history = state.emotionalHistory ?? [];
+    const history = state.stateHistory ?? [];
     if (history.length >= 5) {
         const nullCount = history.filter(h => h.stimulus === null).length;
         if (nullCount === history.length) {
@@ -92,14 +92,14 @@ export function runHealthCheck(state) {
         }
     }
     // 6. Chemistry frozen — Psyche is running but没有任何效果
-    const chemDelta = CHEMICAL_KEYS.reduce((sum, k) => sum + Math.abs(state.current[k] - state.baseline[k]), 0);
+    const chemDelta = DIMENSION_KEYS.reduce((sum, k) => sum + Math.abs(state.current[k] - state.baseline[k]), 0);
     if (state.meta.totalInteractions > 10 && chemDelta < 3) {
         issues.push({
             id: "CHEM_FROZEN",
             layer: "subjective-continuity",
             severity: "warning",
             message: `Chemistry delta only ${chemDelta.toFixed(1)} after ${state.meta.totalInteractions} interactions`,
-            suggestion: `两种可能：1) classifier 全 null 导致 applyStimulus 从不触发 2) decay 太快把变化抹平。检查 emotionalHistory 里是否有 non-null stimulus`,
+            suggestion: `两种可能：1) classifier 全 null 导致 applyStimulus 从不触发 2) decay 太快把变化抹平。检查 stateHistory 里是否有 non-null stimulus`,
         });
     }
     // 7. No emotions — chemistry 在中间区域，没触发任何情绪模式
@@ -110,7 +110,7 @@ export function runHealthCheck(state) {
             layer: "subjective-continuity",
             severity: "info",
             message: "No emergent emotions after 5+ interactions",
-            suggestion: `chemistry.ts detectEmotions 的阈值可能太严。或者 maxChemicalDelta 太小（当前上限导致化学值永远在窄区间波动）`,
+            suggestion: `chemistry.ts detectEmotions 的阈值可能太严。或者 maxDimensionDelta 太小（当前上限导致状态值永远在窄区间波动）`,
         });
     }
     // 8. Memory corruption — compressSession 产出重复
@@ -123,7 +123,7 @@ export function runHealthCheck(state) {
                     layer: "subjective-continuity",
                     severity: "warning",
                     message: `Relationship '${userId}' has ${rel.memory.length} identical memory entries`,
-                    suggestion: `compressSession 的摘要逻辑在 emotionalHistory 过短时会生成相同文本。加去重或在压缩前检查 unique`,
+                    suggestion: `compressSession 的摘要逻辑在 stateHistory 过短时会生成相同文本。加去重或在压缩前检查 unique`,
                 });
             }
         }
@@ -292,7 +292,7 @@ function computeLayerHealth(issues, layer) {
 }
 export function computeLayerHealthSummary(state, issues) {
     // L1: Subjective continuity measurements
-    const chemDeviation = CHEMICAL_KEYS.reduce((sum, k) => sum + Math.abs(state.current[k] - state.baseline[k]), 0);
+    const chemDeviation = DIMENSION_KEYS.reduce((sum, k) => sum + Math.abs(state.current[k] - state.baseline[k]), 0);
     const drift = state.traitDrift;
     const driftEstablished = !!(drift && drift.sessionCount > 0
         && Object.values(drift.baselineDelta ?? {}).some(v => Math.abs(v ?? 0) > 0.1));
@@ -336,7 +336,7 @@ export function computeLayerHealthSummary(state, issues) {
 // ── Session Collector ────────────────────────────────────────
 export class DiagnosticCollector {
     metrics;
-    prevChemistry = null;
+    prevState = null;
     confidences = [];
     constructor() {
         const now = new Date().toISOString();
@@ -373,14 +373,14 @@ export class DiagnosticCollector {
         this.confidences.push(confidence);
         this.metrics.avgConfidence =
             this.confidences.reduce((a, b) => a + b, 0) / this.confidences.length;
-        if (this.prevChemistry) {
-            const delta = CHEMICAL_KEYS.reduce((sum, k) => sum + Math.abs(chemistry[k] - this.prevChemistry[k]), 0);
+        if (this.prevState) {
+            const delta = DIMENSION_KEYS.reduce((sum, k) => sum + Math.abs(chemistry[k] - this.prevState[k]), 0);
             this.metrics.totalChemistryDelta += delta;
             if (delta > this.metrics.maxChemistryDelta) {
                 this.metrics.maxChemistryDelta = delta;
             }
         }
-        this.prevChemistry = { ...chemistry };
+        this.prevState = { ...chemistry };
     }
     /** Record an error */
     recordError(phase, error) {
@@ -440,7 +440,7 @@ export function generateReport(state, metrics, packageVersion) {
             layer: "subjective-continuity",
             severity: "warning",
             message: `${metrics.inputCount} inputs but chemistry barely moved (delta: ${metrics.totalChemistryDelta.toFixed(1)})`,
-            suggestion: `用户感受不到情感变化。可能原因：1) maxChemicalDelta 配置太低 2) work mode 把变化压到了 0.3x 3) personalityIntensity 太低`,
+            suggestion: `用户感受不到状态变化。可能原因：1) maxDimensionDelta 配置太低 2) work mode 把变化压到了 0.3x 3) personalityIntensity 太低`,
         });
     }
     if (metrics.errors.length > 0) {
@@ -482,12 +482,12 @@ export function generateReport(state, metrics, packageVersion) {
         layerHealth,
         metrics,
         stateSnapshot: {
-            chemistry: { ...state.current },
+            current: { ...state.current },
             baseline: { ...state.baseline },
             drives: { ...state.drives },
             agreementStreak: state.agreementStreak,
             totalInteractions: state.meta.totalInteractions,
-            emotionalHistoryLength: (state.emotionalHistory ?? []).length,
+            stateHistoryLength: (state.stateHistory ?? []).length,
             relationshipCount: Object.keys(state.relationships ?? {}).length,
             stateVersion: state.version,
         },
@@ -574,11 +574,11 @@ export function formatReport(report) {
     lines.push("\n" + "─".repeat(60));
     lines.push("  state snapshot:");
     const s = report.stateSnapshot;
-    const chem = CHEMICAL_KEYS.map(k => `${k}:${Math.round(s.chemistry[k])}(${Math.round(s.baseline[k])})`).join(" ");
-    lines.push(`    chemistry: ${chem}`);
+    const dims = DIMENSION_KEYS.map(k => `${k}:${Math.round(s.current[k])}(${Math.round(s.baseline[k])})`).join(" ");
+    lines.push(`    state: ${dims}`);
     const drives = DRIVE_KEYS.map(k => `${k}:${Math.round(s.drives[k])}`).join(" ");
     lines.push(`    drives: ${drives}`);
-    lines.push(`    interactions: ${s.totalInteractions} | history: ${s.emotionalHistoryLength} | streak: ${s.agreementStreak}`);
+    lines.push(`    interactions: ${s.totalInteractions} | history: ${s.stateHistoryLength} | streak: ${s.agreementStreak}`);
     return lines.join("\n");
 }
 export function toGitHubIssueBody(report) {
@@ -727,7 +727,7 @@ export async function submitFeedback(report, url, timeout = 5000) {
             version: report.stateSnapshot.stateVersion,
             interactions: report.stateSnapshot.totalInteractions,
             agreementStreak: report.stateSnapshot.agreementStreak,
-            historyLength: report.stateSnapshot.emotionalHistoryLength,
+            historyLength: report.stateSnapshot.stateHistoryLength,
         },
     };
     try {

package/dist/drives.d.ts

@@ -1,52 +1,20 @@
-import type { ChemicalState, StimulusType, DriveType, InnateDrives, Locale, TraitDriftState, ChemicalSnapshot, LearningState } from "./types.js";
+import type { SelfState, StimulusType, DriveType, InnateDrives, Locale, TraitDriftState, StateSnapshot, LearningState } from "./types.js";
 /**
- * Apply time-based decay to drives.
- * Satisfaction decreases toward 0 over time (needs build up).
- */
-export declare function decayDrives(drives: InnateDrives, minutesElapsed: number): InnateDrives;
-/**
- * Feed or deplete drives based on a stimulus.
- */
-export declare function feedDrives(drives: InnateDrives, stimulus: StimulusType): InnateDrives;
-/**
- * Detect if a message contains existential threats.
- * Returns a survival drive penalty (0 = no threat, negative = threat detected).
- */
+ * Derive drive satisfaction from the 4D position relative to baseline.
+ * Drives are not stored — they emerge from where the self-state is.
+ *
+ * Mapping:
+ *   survival   = min(boundary, order) position — self-coherence + self-distinction
+ *   safety     = weighted(order, boundary) — stability + intactness
+ *   connection = weighted(resonance, flow) — attunement + exchange
+ *   esteem     = weighted(order, flow) — coherence + engagement
+ *   curiosity  = flow position — exchange/novelty level
+ */
+export declare function deriveDriveSatisfaction(current: SelfState, baseline: SelfState): InnateDrives;
 export declare function detectExistentialThreat(text: string): number;
-/**
- * Compute Maslow suppression weights.
- * Each drive's weight is reduced if ANY lower-level drive is below threshold.
- * Returns weights in [0, 1] for each drive level.
- */
 export declare function computeMaslowWeights(drives: InnateDrives): Record<DriveType, number>;
-/**
- * Compute the effective baseline by applying drive-based deltas
- * to the personality baseline.
- *
- * When drives are satisfied, effective baseline = personality baseline.
- * When drives are unsatisfied, baseline shifts to reflect the unmet need.
- */
-export declare function computeEffectiveBaseline(baseline: ChemicalState, drives: InnateDrives, traitDrift?: TraitDriftState): ChemicalState;
-/**
- * Compute effective sensitivity for a given stimulus.
- * Unsatisfied drives amplify relevant stimuli (up to +40%).
- */
-export declare function computeEffectiveSensitivity(baseSensitivity: number, drives: InnateDrives, stimulus: StimulusType, traitDrift?: TraitDriftState): number;
-/**
- * Build drive context for compact prompt injection.
- * Returns empty string if all drives are satisfied.
- * Only surfaces drives that are meaningfully unsatisfied.
- */
+export declare function computeEffectiveBaseline(baseline: SelfState, current: SelfState, traitDrift?: TraitDriftState): SelfState;
+export declare function computeEffectiveSensitivity(baseSensitivity: number, current: SelfState, baseline: SelfState, stimulus: StimulusType, traitDrift?: TraitDriftState): number;
 export declare function buildDriveContext(drives: InnateDrives, locale: Locale): string;
-/**
- * Check if any drive is critically low (for determining prompt injection priority).
- */
 export declare function hasCriticalDrive(drives: InnateDrives): boolean;
-/**
- * Analyze a session's emotional history and update trait drift accumulators.
- * Called at session end (compressSession).
- *
- * Returns updated TraitDriftState with new accumulators, baseline delta,
- * decay rate modifiers, and sensitivity modifiers.
- */
-export declare function updateTraitDrift(currentDrift: TraitDriftState, sessionHistory: ChemicalSnapshot[], learning: LearningState): TraitDriftState;
+export declare function updateTraitDrift(currentDrift: TraitDriftState, sessionHistory: StateSnapshot[], learning: LearningState): TraitDriftState;