clawmate 1.3.0 → 1.4.1

package/renderer/js/memory.js

@@ -1,9 +1,9 @@
 /**
- * 사용자 상호작용 기억 + 진화 시스템
+ * User interaction memory + evolution system
  *
- * - 클릭 횟수, 일수, 마일스톤 추적
- * - 진화 단계 관리: 항상 긍정적/귀여운 방향으로만 진화
- * - 무서운/끔찍한 모습으로는 절대 변하지 않음
+ * - Tracks click count, days, milestones
+ * - Evolution stage management: always evolves in positive/cute directions only
+ * - Never transforms into scary/creepy appearances
  */
 const Memory = (() => {
   let data = {
@@ -13,9 +13,23 @@ const Memory = (() => {
     lastVisitDate: null,
     milestones: [],
     evolutionStage: 0,
-    interactionStreak: 0,    // 연속 방문 일수
+    interactionStreak: 0,    // Consecutive visit days
+
+    // --- Motion history ---
+    motionHistory: [],       // Recent 100 state transition records [{state, timestamp, duration}]
+    motionStats: {},         // Accumulated time per state {idle: 12345, walking: 6789, ...}
+
+    // --- User reaction storage ---
+    reactionLog: [],         // Recent 50 user reactions [{action, reaction, timestamp}]
+    favoriteActions: {},     // Positive reaction count per action {excited: 5, walking: 2, ...}
+    dislikedActions: {},     // Negative reaction count per action (ignored/abandoned)
   };
 
+  let lastMotionState = null;
+  let lastMotionTime = 0;
+  const MAX_MOTION_HISTORY = 100;
+  const MAX_REACTION_LOG = 50;
+
   let evolutionStages = null;
 
   async function init() {
@@ -26,22 +40,22 @@ const Memory = (() => {
 
     evolutionStages = window._evolutionStages;
 
-    // 첫 실행
+    // First run
     if (!data.firstRunDate) {
       data.firstRunDate = new Date().toISOString();
       await save();
     }
 
-    // 일수 계산
+    // Calculate days
     updateDayCount();
 
-    // 마일스톤 체크
+    // Check milestones
     checkMilestones();
 
-    // 진화 체크
+    // Check evolution
     checkEvolution();
 
-    // 진화 시각 효과 적용
+    // Apply evolution visual effects
     applyEvolutionVisuals();
   }
 
@@ -50,7 +64,7 @@ const Memory = (() => {
     const now = new Date();
     data.totalDays = Math.floor((now - firstRun) / (1000 * 60 * 60 * 24));
 
-    // 연속 방문 체크
+    // Check consecutive visits
     const lastVisit = data.lastVisitDate ? new Date(data.lastVisitDate) : null;
     const today = now.toDateString();
     if (lastVisit && lastVisit.toDateString() !== today) {
@@ -89,7 +103,7 @@ const Memory = (() => {
         data.milestones.push(check.key);
         const msg = Speech.getMilestoneMessage(check.key);
         if (msg) {
-          // 약간의 딜레이 후 마일스톤 메시지 표시
+          // Display milestone message after a slight delay
           setTimeout(() => {
             Speech.show(msg);
             Interactions.spawnStarEffect();
@@ -100,9 +114,9 @@ const Memory = (() => {
   }
 
   /**
-   * 진화 단계 체크
-   * 항상 올라가기만 함 (퇴화 없음)
-   * 조건: 클릭 횟수 + 함께한 일수 모두 충족
+   * Check evolution stage
+   * Only goes up (no devolution)
+   * Condition: both click count and days together must be met
    */
   function checkEvolution() {
     if (!evolutionStages) return;
@@ -127,22 +141,22 @@ const Memory = (() => {
   }
 
   /**
-   * 진화 발생 시 이벤트
-   * - 밝은 플래시 효과 (부드러운 빛)
-   * - 반짝이 파티클
-   * - 축하 메시지
+   * Evolution event handler
+   * - Bright flash effect (soft light)
+   * - Sparkle particles
+   * - Congratulatory message
    */
   function onEvolution(prevStage, newStage) {
     const msgs = window._messages;
     const stageInfo = evolutionStages[newStage];
 
-    // 밝은 플래시 (무섭지 않은 부드러운 효과)
+    // Bright flash (soft, non-scary effect)
     const flash = document.createElement('div');
     flash.className = 'evolve-flash';
     document.body.appendChild(flash);
     setTimeout(() => flash.remove(), 600);
 
-    // 진화 반짝임 파티클 (밝은 색상만)
+    // Evolution sparkle particles (bright colors only)
     const pos = PetEngine.getPosition();
     const sparkleColors = ['#FFD700', '#FF69B4', '#87CEEB', '#98FB98', '#DDA0DD'];
     for (let i = 0; i < 16; i++) {
@@ -155,7 +169,7 @@ const Memory = (() => {
       setTimeout(() => sparkle.remove(), 800);
     }
 
-    // 진화 링 이펙트 (따뜻한 색)
+    // Evolution ring effect (warm colors)
     const ring = document.createElement('div');
     ring.className = 'evolve-ring';
     ring.style.width = '64px';
@@ -166,7 +180,7 @@ const Memory = (() => {
     document.getElementById('world').appendChild(ring);
     setTimeout(() => ring.remove(), 1000);
 
-    // 축하 메시지
+    // Congratulatory message
     if (msgs && msgs.evolution) {
       const evolveMsg = msgs.evolution[`stage_${newStage}`];
       if (evolveMsg) {
@@ -174,13 +188,13 @@ const Memory = (() => {
       }
     }
 
-    // 시각 효과 업데이트
+    // Update visual effects
     applyEvolutionVisuals();
   }
 
   /**
-   * 진화 단계에 따른 시각적 변화 적용
-   * 항상 긍정적: 밝아지고, 반짝이고, 귀여운 악세사리 추가
+   * Apply visual changes based on evolution stage
+   * Always positive: gets brighter, sparkly, and cute accessories added
    */
   function applyEvolutionVisuals() {
     if (!evolutionStages) return;
@@ -190,17 +204,17 @@ const Memory = (() => {
     const pet = document.getElementById('pet-container');
     if (!pet) return;
 
-    // 크기 스케일
+    // Size scale
     pet.style.transform = pet.style.transform || '';
 
-    // 밝기/채도 — 진화할수록 밝고 화사해짐
+    // Brightness/saturation -- gets brighter and more vibrant with evolution
     const { brightness, saturation } = stage.colorMod;
     const canvas = pet.querySelector('canvas');
     if (canvas) {
       canvas.style.filter = `brightness(${brightness}) saturate(${saturation})`;
     }
 
-    // 악세사리 제거 후 재적용
+    // Remove accessories then reapply
     pet.querySelectorAll('.accessory').forEach(a => a.remove());
 
     for (const acc of stage.accessories) {
@@ -209,8 +223,8 @@ const Memory = (() => {
   }
 
   /**
-   * 귀여운 악세사리 추가
-   * 모든 악세사리는 밝고 귀여운 요소만
+   * Add cute accessories
+   * All accessories are bright and cute elements only
    */
   function addAccessory(container, type) {
     const acc = document.createElement('div');
@@ -221,7 +235,7 @@ const Memory = (() => {
 
     switch (type) {
       case 'blush':
-        // 양 볼에 핑크 동그라미
+        // Pink circles on both cheeks
         acc.style.width = '8px';
         acc.style.height = '6px';
         acc.style.borderRadius = '50%';
@@ -229,14 +243,14 @@ const Memory = (() => {
         acc.style.left = '12px';
         acc.style.top = '38px';
         container.appendChild(acc);
-        // 오른쪽 볼
+        // Right cheek
         const blush2 = acc.cloneNode();
         blush2.style.left = '44px';
         container.appendChild(blush2);
         return;
 
       case 'sparkle_eyes':
-        // 눈에 반짝임 (흰색 작은 점)
+        // Eye sparkles (small white dots)
         acc.style.width = '3px';
         acc.style.height = '3px';
         acc.style.borderRadius = '50%';
@@ -286,14 +300,14 @@ const Memory = (() => {
         break;
 
       case 'wings':
-        // 작은 천사 날개 (왼쪽)
+        // Small angel wings (left)
         acc.textContent = '\u{1FABD}';
         acc.style.fontSize = '10px';
         acc.style.left = '-6px';
         acc.style.top = '20px';
         acc.style.opacity = '0.7';
         container.appendChild(acc);
-        // 오른쪽 날개
+        // Right wing
         const wing2 = acc.cloneNode(true);
         wing2.style.left = '58px';
         wing2.style.transform = 'scaleX(-1)';
@@ -304,6 +318,95 @@ const Memory = (() => {
     container.appendChild(acc);
   }
 
+  // --- Motion history recording ---
+
+  /**
+   * Record state transition
+   * Called when state changes in StateMachine
+   */
+  function recordMotion(newState) {
+    const now = Date.now();
+
+    // Calculate previous state duration -> accumulate statistics
+    if (lastMotionState && lastMotionTime > 0) {
+      const duration = now - lastMotionTime;
+      if (!data.motionStats[lastMotionState]) data.motionStats[lastMotionState] = 0;
+      data.motionStats[lastMotionState] += duration;
+    }
+
+    // Add to history
+    data.motionHistory.push({
+      state: newState,
+      timestamp: now,
+      from: lastMotionState || 'init',
+    });
+
+    // Remove old entries when exceeding max size
+    if (data.motionHistory.length > MAX_MOTION_HISTORY) {
+      data.motionHistory = data.motionHistory.slice(-MAX_MOTION_HISTORY);
+    }
+
+    lastMotionState = newState;
+    lastMotionTime = now;
+
+    // Auto-save every 10 transitions
+    if (data.motionHistory.length % 10 === 0) save();
+  }
+
+  /**
+   * Record user reaction
+   * When user shows reactions like click/drag during a specific action
+   *
+   * @param {string} action - Action the pet was performing
+   * @param {string} reaction - 'click' | 'drag' | 'cursor_near' | 'triple_click' | 'double_click'
+   */
+  function recordReaction(action, reaction) {
+    const now = Date.now();
+
+    // Add to reaction log
+    data.reactionLog.push({ action, reaction, timestamp: now });
+    if (data.reactionLog.length > MAX_REACTION_LOG) {
+      data.reactionLog = data.reactionLog.slice(-MAX_REACTION_LOG);
+    }
+
+    // Click/double-click classified as positive reactions
+    if (reaction === 'click' || reaction === 'double_click' || reaction === 'cursor_near') {
+      if (!data.favoriteActions[action]) data.favoriteActions[action] = 0;
+      data.favoriteActions[action]++;
+    }
+    // Drag (grab and move) is a slightly negative reaction
+    if (reaction === 'drag') {
+      if (!data.dislikedActions[action]) data.dislikedActions[action] = 0;
+      data.dislikedActions[action]++;
+    }
+
+    save();
+  }
+
+  /**
+   * Return top N user-preferred actions
+   * Referenced by AI when deciding actions
+   */
+  function getFavoriteActions(topN = 5) {
+    const entries = Object.entries(data.favoriteActions || {});
+    entries.sort((a, b) => b[1] - a[1]);
+    return entries.slice(0, topN).map(([action, count]) => ({ action, count }));
+  }
+
+  /**
+   * Return recent motion history
+   */
+  function getMotionHistory(limit = 20) {
+    return (data.motionHistory || []).slice(-limit);
+  }
+
+  /**
+   * Return accumulated time per state
+   */
+  function getMotionStats() {
+    return { ...(data.motionStats || {}) };
+  }
+
   async function save() {
     try {
       await window.clawmate.saveMemory(data);
@@ -318,5 +421,9 @@ const Memory = (() => {
     return data.evolutionStage;
   }
 
-  return { init, recordClick, getData, getEvolutionStage, save };
+  return {
+    init, recordClick, getData, getEvolutionStage, save,
+    recordMotion, recordReaction, getFavoriteActions,
+    getMotionHistory, getMotionStats,
+  };
 })();