clawmate 1.4.0 → 1.4.2

package/renderer/js/app.js

@@ -1,21 +1,21 @@
 /**
- * ClawMate 렌더러 초기화
+ * ClawMate renderer initialization
  *
- * 아키텍처:
- *   AI (뇌) ←→ AI Bridge (WebSocket) ←→ AI Controller (렌더러)
- *                                                       ↓
+ * Architecture:
+ *   AI (brain) <-> AI Bridge (WebSocket) <-> AI Controller (renderer)
+ *                                                       |
  *                                          StateMachine / PetEngine / Speech
  *
- * AI 연결 시: AI가 모든 행동/말/감정 결정
- * AI 미연결 시: 자율 모드 (FSM 기반) 로 혼자 놀기
+ * When AI connected: AI decides all behaviors/speech/emotions
+ * When AI disconnected: Autonomous mode (FSM-based) plays alone
  */
 (async function initClawMate() {
   const petContainer = document.getElementById('pet-container');
 
-  // 캐릭터 캔버스 생성
+  // Create character canvas
   Character.createCanvas(petContainer);
 
-  // 기본 색상 설정 (Pet 모드)
+  // Set default colors (Pet mode)
   Character.setColorMap({
     primary: '#ff4f40',
     secondary: '#ff775f',
@@ -25,7 +25,7 @@
     claw: '#ff4f40',
   });
 
-  // 상태 변화 콜백
+  // State change callback
   StateMachine.setOnStateChange((prevState, newState) => {
     if (newState === 'sleeping') {
       const pet = document.getElementById('pet-container');
@@ -45,10 +45,10 @@
       Interactions.spawnStarEffect();
     }
 
-    // 모션 히스토리 기록
+    // Record motion history
     Memory.recordMotion(newState);
 
-    // 상태 변화를 AI에 리포트
+    // Report state changes to AI
     if (window.clawmate.reportToAI) {
       window.clawmate.reportToAI('state_change', {
         from: prevState, to: newState,
@@ -56,48 +56,48 @@
     }
   });
 
-  // 이동 엔진 초기화
+  // Initialize movement engine
   PetEngine.init(petContainer);
 
-  // 모드 매니저 초기화
+  // Initialize mode manager
   await ModeManager.init();
 
-  // 메모리 초기화 (진화 상태 포함)
+  // Initialize memory (including evolution state)
   await Memory.init();
 
-  // AI 컨트롤러 초기화 (AI 연결 관리)
+  // Initialize AI controller (AI connection management)
   AIController.init();
 
-  // 상호작용 초기화
+  // Initialize interactions
   Interactions.init();
 
-  // 시간 인식 초기화 (자율 모드에서만 주도적으로 동작)
+  // Initialize time awareness (only proactive in autonomous mode)
   TimeAware.init();
 
-  // 메트릭 수집기 초기화 (선택적 — 없어도 앱 정상 동작)
+  // Initialize metrics collector (optional -- app works fine without it)
   if (typeof Metrics !== 'undefined') {
     Metrics.init();
   }
 
-  // 브라우저 감시 초기화 (참견쟁이 모드)
+  // Initialize browser watcher (nosy mode)
   if (typeof BrowserWatcher !== 'undefined') {
     BrowserWatcher.init();
   }
 
-  // 엔진 시작
+  // Start engine
   PetEngine.start();
 
-  // 말풍선 위치 업데이트 루프
+  // Speech bubble position update loop
   setInterval(() => {
     Speech.updatePosition();
   }, 100);
 
-  // AI 연결 상태 표시
+  // Display AI connection status
   const connected = await window.clawmate.isAIConnected();
   if (connected) {
-    Speech.show('AI와 연결됨. 지시를 기다리는 중...');
+    Speech.show('Connected to AI. Awaiting instructions...');
   } else {
-    Speech.show('안녕! 나 혼자서도 잘 놀 수 있어!');
+    Speech.show('Hi! I can play on my own just fine!');
   }
 
   addDynamicStyles();

package/renderer/js/browser-watcher.js

@@ -1,22 +1,22 @@
 /**
- * 브라우저 활동 감시 + AI 코멘트 시스템
+ * Browser activity watcher + AI comment system
  *
- * 두 가지 모드:
- *   AI 연결 시: 윈도우 제목 + 화면 캡처 + 커서 위치를 AI에 전송 → AI가 맥락 있는 코멘트 생성
- *   AI 미연결 시: 프리셋 메시지로 폴백 (자율 모드)
+ * Two modes:
+ *   When AI connected: Send window title + screen capture + cursor position to AI -> AI generates contextual comments
+ *   When AI disconnected: Fall back to preset messages (autonomous mode)
  *
- * 동작:
- *   1. 15초마다 활성 윈도우 제목 + 커서 위치 조회
- *   2. 브라우저/앱 감지 시 AI에 컨텍스트 리포트 (제목 + 화면 캡처)
- *   3. AI가 제목/캡처를 분석해서 상황 맞는 코멘트 생성
- *   4. 자율 모드에서는 프리셋 메시지 폴백
+ * Behavior:
+ *   1. Check active window title + cursor position every 15 seconds
+ *   2. Report context to AI when browser/app detected (title + screen capture)
+ *   3. AI analyzes title/capture and generates situation-appropriate comments
+ *   4. Fall back to preset messages in autonomous mode
  */
 const BrowserWatcher = (() => {
-  const CHECK_INTERVAL = 15000;     // 활성 윈도우 체크 주기 (15초)
-  const AI_COOLDOWN = 45000;        // AI 코멘트 쿨다운 (45초)
-  const FALLBACK_COOLDOWN = 90000;  // 자율 모드 코멘트 쿨다운 (90초)
-  const COMMENT_CHANCE = 0.4;       // 코멘트 확률 (40%)
-  const SITE_CHANGE_BONUS = 0.3;    // 사이트 변경 시 추가 확률
+  const CHECK_INTERVAL = 15000;     // Active window check interval (15s)
+  const AI_COOLDOWN = 45000;        // AI comment cooldown (45s)
+  const FALLBACK_COOLDOWN = 90000;  // Autonomous mode comment cooldown (90s)
+  const COMMENT_CHANCE = 0.4;       // Comment probability (40%)
+  const SITE_CHANGE_BONUS = 0.3;    // Additional probability on site change
 
   let intervalId = null;
   let lastCategory = null;
@@ -26,7 +26,7 @@ const BrowserWatcher = (() => {
 
   function init() {
     intervalId = setInterval(check, CHECK_INTERVAL);
-    // 첫 체크는 10초 후 (앱 시작 직후는 건너뜀)
+    // First check after 10 seconds (skip right after app start)
     setTimeout(check, 10000);
   }
 
@@ -34,7 +34,7 @@ const BrowserWatcher = (() => {
     if (!enabled) return;
     if (typeof Speech === 'undefined') return;
 
-    // sleeping 상태면 참견 안 함
+    // Don't comment when in sleeping state
     if (typeof StateMachine !== 'undefined' && StateMachine.getState() === 'sleeping') return;
 
     try {
@@ -47,25 +47,25 @@ const BrowserWatcher = (() => {
 
       const now = Date.now();
 
-      // 카테고리 매칭 (AI/자율 모두 사용)
+      // Category matching (used by both AI and autonomous modes)
       const msgs = window._messages;
       const match = msgs?.browsing ? findCategory(titleLower, msgs.browsing) : null;
       const category = match?.category || 'unknown';
 
-      // 쿨다운 체크
+      // Cooldown check
       const isAI = typeof AIController !== 'undefined' && AIController.isConnected();
       const cooldown = isAI ? AI_COOLDOWN : FALLBACK_COOLDOWN;
       if (now - lastCommentTime < cooldown) return;
 
-      // 같은 카테고리 + 제목 미변경 시 스킵
+      // Skip if same category and title unchanged
       if (category === lastCategory && !titleChanged) return;
 
-      // 확률 체크
+      // Probability check
       let chance = COMMENT_CHANCE;
       if (titleChanged) chance += SITE_CHANGE_BONUS;
       if (Math.random() > chance) return;
 
-      // === AI vs 자율 모드 분기 ===
+      // === AI vs autonomous mode branch ===
       if (isAI) {
         await reportBrowsingToAI(title, category, titleChanged);
       } else {
@@ -75,19 +75,19 @@ const BrowserWatcher = (() => {
       lastCategory = category;
       lastCommentTime = now;
     } catch {
-      // IPC 실패 무시
+      // Ignore IPC failure
     }
   }
 
   /**
-   * AI에 브라우징 컨텍스트 전송
-   * 제목 + 커서 위치 + 화면 캡처를 한번에 전송
-   * AI가 분석하고 코멘트 생성
+   * Send browsing context to AI
+   * Transmit title + cursor position + screen capture together
+   * AI analyzes and generates comments
    */
   async function reportBrowsingToAI(title, category, titleChanged) {
     if (!window.clawmate.reportToAI) return;
 
-    // 커서 위치 조회
+    // Get cursor position
     let cursorX = 0, cursorY = 0;
     try {
       if (window.clawmate.getCursorPosition) {
@@ -97,7 +97,7 @@ const BrowserWatcher = (() => {
       }
     } catch {}
 
-    // 화면 캡처 (AI가 페이지 내용을 시각적으로 분석하기 위해)
+    // Screen capture (for AI to visually analyze page content)
     let screenData = null;
     try {
       const capture = await window.clawmate.screen.capture();
@@ -110,7 +110,7 @@ const BrowserWatcher = (() => {
       }
     } catch {}
 
-    // 통합 브라우징 리포트 전송
+    // Send unified browsing report
     window.clawmate.reportToAI('browsing', {
       title,
       category,
@@ -123,7 +123,7 @@ const BrowserWatcher = (() => {
   }
 
   /**
-   * 자율 모드 폴백: 프리셋 메시지 표시
+   * Autonomous mode fallback: display preset messages
    */
   function showFallbackComment(match) {
     if (!match?.data?.comments) return;
@@ -132,7 +132,7 @@ const BrowserWatcher = (() => {
     const comment = comments[Math.floor(Math.random() * comments.length)];
     Speech.show(comment);
 
-    // 50% 확률로 흥분 애니메이션
+    // 50% chance of excitement animation
     if (typeof StateMachine !== 'undefined') {
       const state = StateMachine.getState();
       if ((state === 'idle' || state === 'walking') && Math.random() < 0.5) {
@@ -145,8 +145,8 @@ const BrowserWatcher = (() => {
   }
 
   /**
-   * 카테고리 매칭 (키워드 기반)
-   * general은 다른 카테고리 매칭 안 될 때만 사용
+   * Category matching (keyword-based)
+   * 'general' is only used when no other category matches
    */
   function findCategory(titleLower, browsingMsgs) {
     let generalMatch = null;

package/renderer/js/character.js

@@ -1,20 +1,20 @@
 /**
- * 픽셀 아트 랍스터(Claw) 캐릭터 렌더러
- * 16x16 그리드 → CSS div로 렌더링 → 4x 확대 (64x64px)
+ * Pixel art lobster (Claw) character renderer
+ * 16x16 grid -> rendered as CSS div -> 4x scaled (64x64px)
  *
- * 색상 코드:
- *   0 = 투명, 1 = primary(빨강), 2 = secondary(연빨강),
- *   3 = dark(갈색), 4 = eye, 5 = pupil, 6 = claw 전용
+ * Color codes:
+ *   0 = transparent, 1 = primary (red), 2 = secondary (light red),
+ *   3 = dark (brown), 4 = eye, 5 = pupil, 6 = claw specific
  */
 const Character = (() => {
   const PIXEL = 4;
   const GRID = 16;
   const SIZE = PIXEL * GRID;
 
-  // --- 프레임 데이터 (16x16 배열) ---
+  // --- Frame data (16x16 arrays) ---
   const FRAMES = {
     idle: [
-      // Frame 0: 기본 자세 — 집게 열림
+      // Frame 0: Default pose -- claws open
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -33,7 +33,7 @@ const Character = (() => {
         [0,3,3,3,0,0,0,3,3,0,0,0,3,3,3,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 1: 집게 닫힘 (물결)
+      // Frame 1: Claws closed (wave)
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -55,7 +55,7 @@ const Character = (() => {
     ],
 
     walk: [
-      // Frame 0: 왼쪽 다리 세트 앞으로 크게 벌림, 집게 열림
+      // Frame 0: Left leg set extended forward wide, claws open
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -74,7 +74,7 @@ const Character = (() => {
         [3,3,0,0,0,0,0,3,3,0,0,0,0,0,3,3],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 1: 양쪽 다리 모임 (접촉 순간), 집게 반 닫힘
+      // Frame 1: Both leg sets together (contact moment), claws half-closed
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -93,7 +93,7 @@ const Character = (() => {
         [0,0,0,3,3,0,0,3,3,0,0,3,3,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 2: 오른쪽 다리 세트 앞으로 크게 벌림, 집게 닫힘
+      // Frame 2: Right leg set extended forward wide, claws closed
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -112,7 +112,7 @@ const Character = (() => {
         [0,3,3,0,0,0,0,3,3,0,0,0,0,3,3,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 3: 양쪽 다리 모임 (접촉 순간), 집게 반 열림
+      // Frame 3: Both leg sets together (contact moment), claws half-open
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -134,7 +134,7 @@ const Character = (() => {
     ],
 
     climb: [
-      // Frame 0: 기어오르기 — 윗다리 세트 뻗음, 집게 열림
+      // Frame 0: Climbing -- upper leg set extended, claws open
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,6,6,0,0,0,0,0,0,0,0,0,0],
@@ -153,7 +153,7 @@ const Character = (() => {
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 1: 기어오르기 — 다리 모임 (교차 순간)
+      // Frame 1: Climbing -- legs together (crossing moment)
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,6,6,0,0,0,0,0,0,0,0,0,0],
@@ -172,7 +172,7 @@ const Character = (() => {
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 2: 기어오르기 — 아랫다리 세트 뻗음, 집게 닫힘
+      // Frame 2: Climbing -- lower leg set extended, claws closed
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,6,6,0,0,0,0,0,0,0,0,0,0],
@@ -191,7 +191,7 @@ const Character = (() => {
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 3: 기어오르기 — 다리 모임 (교차 순간, 반대쪽)
+      // Frame 3: Climbing -- legs together (crossing moment, opposite side)
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,6,6,0,0,0,0,0,0,0,0,0,0],
@@ -234,7 +234,7 @@ const Character = (() => {
     ],
 
     carry: [
-      // Frame 0: 파일 들고 걷기 1
+      // Frame 0: Walking with file 1
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,1,1,1,1,0,0,1,1,1,1,6,0,0],
@@ -253,7 +253,7 @@ const Character = (() => {
         [0,3,3,3,0,0,0,3,3,0,0,0,3,3,3,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 1: 파일 들고 걷기 2
+      // Frame 1: Walking with file 2
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,1,1,1,1,0,0,1,1,1,1,6,0,0],
@@ -275,7 +275,7 @@ const Character = (() => {
     ],
 
     scared: [
-      // Frame 0: 놀람 — 눈 크게
+      // Frame 0: Startled -- eyes wide
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -294,7 +294,7 @@ const Character = (() => {
         [0,3,3,3,0,0,0,3,3,0,0,0,3,3,3,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 1: 뒤로 움찔
+      // Frame 1: Flinch backward
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,6,6,0,0,0,0,0,0,6,6,0,0,0],
@@ -316,7 +316,7 @@ const Character = (() => {
     ],
 
     excited: [
-      // Frame 0: 점프 업
+      // Frame 0: Jump up
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,6,6,0,0,0,0,0,0,0,0,0,0,6,6,0],
@@ -335,7 +335,7 @@ const Character = (() => {
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
       ],
-      // Frame 1: 착지
+      // Frame 1: Landing
       [
         [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
         [0,0,6,6,0,0,0,0,0,0,0,0,6,6,0,0],
@@ -357,7 +357,7 @@ const Character = (() => {
     ],
   };
 
-  // 상태 → 프레임셋 매핑
+  // State -> frameset mapping
   const STATE_FRAMES = {
     idle: 'idle',
     walking: 'walk',
@@ -370,15 +370,15 @@ const Character = (() => {
     interacting: 'excited',
     scared: 'scared',
     excited: 'excited',
-    jumping: 'excited',    // 점프: excited 프레임셋 재활용
-    rappelling: 'climb',   // 레펠: climb 프레임셋 재활용
-    falling: 'scared',     // 낙하: scared 프레임셋 재활용
-    custom: 'walk',        // 커스텀 이동: 기본은 walk, 패턴별로 동적 변경 가능
+    jumping: 'excited',    // Jump: reuse excited frameset
+    rappelling: 'climb',   // Rappel: reuse climb frameset
+    falling: 'scared',     // Falling: reuse scared frameset
+    custom: 'walk',        // Custom movement: default is walk, can be dynamically changed per pattern
   };
 
   let currentCanvas = null;
   let currentColorMap = null;
-  let originalFrames = null;  // 원본 프레임 백업 (리셋용)
+  let originalFrames = null;  // Original frame backup (for reset)
 
   function createCanvas(container) {
     const canvas = document.createElement('canvas');
@@ -436,8 +436,8 @@ const Character = (() => {
   }
 
   /**
-   * 커스텀 프레임 데이터 설정 (AI 생성 캐릭터용)
-   * 기존 프레임을 백업하고 새 프레임으로 교체
+   * Set custom frame data (for AI-generated characters)
+   * Backs up existing frames and replaces with new ones
    */
   function setCustomFrames(newFrames) {
     if (!originalFrames) {
@@ -454,7 +454,7 @@ const Character = (() => {
   }
 
   /**
-   * 캐릭터 데이터 일괄 설정 (색상 + 프레임)
+   * Batch set character data (colors + frames)
    * @param {object} data - { colorMap?, frames? }
    */
   function setCharacterData(data) {
@@ -467,7 +467,7 @@ const Character = (() => {
   }
 
   /**
-   * 원래 캐릭터로 리셋
+   * Reset to original character
    */
   function resetCharacter() {
     if (originalFrames) {
@@ -477,7 +477,7 @@ const Character = (() => {
       Object.assign(FRAMES, originalFrames);
       originalFrames = null;
     }
-    // 기본 색상으로 리셋
+    // Reset to default colors
     setColorMap({
       primary: '#ff4f40',
       secondary: '#ff775f',

package/renderer/js/interactions.js

@@ -1,8 +1,8 @@
 /**
- * 마우스/클릭/드래그 상호작용 시스템
+ * Mouse/click/drag interaction system
  *
- * AI 연결 시: 이벤트를 AI에 전달 → AI가 반응 결정
- * AI 미연결 시: 자율 반응 (랜덤 FSM)
+ * When AI connected: Events forwarded to AI -> AI decides reactions
+ * When AI disconnected: Autonomous reactions (random FSM)
  */
 const Interactions = (() => {
   let isDragging = false;
@@ -76,7 +76,7 @@ const Interactions = (() => {
 
     const endPos = PetEngine.getPosition();
 
-    // 화면 가장자리까지의 거리 계산
+    // Calculate distance to screen edges
     const screenW = window.innerWidth;
     const screenH = window.innerHeight;
     const charSize = PetEngine.CHAR_SIZE;
@@ -86,15 +86,15 @@ const Interactions = (() => {
     const distRight = screenW - charSize - endPos.x;
     const minEdgeDist = Math.min(distBottom, distTop, distLeft, distRight);
 
-    // 가장자리에서 충분히 떨어져 있으면 (화면 중앙 근처) → 낙하
-    // 가장자리 근처 임계값: 화면 짧은 변의 15%
+    // If far enough from edges (near screen center) -> free fall
+    // Edge proximity threshold: 15% of the shorter screen dimension
     const edgeThreshold = Math.min(screenW, screenH) * 0.15;
 
     if (minEdgeDist > edgeThreshold) {
-      // 화면 중앙 근처: 중력 낙하로 바닥까지 떨어짐
+      // Near screen center: gravity fall to the floor
       PetEngine.startFalling();
     } else {
-      // 가장자리 근처: 기존대로 가장 가까운 가장자리에 붙음
+      // Near edge: snap to the nearest edge as before
       PetEngine.snapToNearestEdge();
       StateMachine.forceState('idle');
     }
@@ -102,7 +102,7 @@ const Interactions = (() => {
     PetEngine.start();
     window.clawmate.setClickThrough(true);
 
-    // AI에 드래그 이벤트 리포트 + 반응 기록
+    // Report drag event to AI + record reaction
     if (dragStartPos) {
       const draggedAction = StateMachine.getState();
       Memory.recordReaction(draggedAction, 'drag');
@@ -114,14 +114,14 @@ const Interactions = (() => {
     const pos = PetEngine.getPosition();
     const currentAction = StateMachine.getState();
 
-    // AI에 클릭 이벤트 리포트
+    // Report click event to AI
     AIController.reportClick(pos);
 
-    // 유저 반응 기록 — 현재 행동 중 클릭 = 긍정 반응
+    // Record user reaction -- click during current action = positive reaction
     Memory.recordReaction(currentAction, 'click');
 
-    // AI 연결 시: AI가 반응 결정 (아무것도 안 함, AI 응답 대기)
-    // AI 미연결 시: 자율 반응
+    // When AI connected: AI decides reaction (do nothing, wait for AI response)
+    // When AI disconnected: autonomous reaction
     if (AIController.isAutonomous()) {
       StateMachine.forceState('interacting');
       Speech.show(Speech.getReactionMessage());
@@ -135,26 +135,26 @@ const Interactions = (() => {
     const pos = PetEngine.getPosition();
     const currentAction = StateMachine.getState();
 
-    // 유저 반응 기록
+    // Record user reaction
     Memory.recordReaction(currentAction, 'double_click');
 
-    // AI에 더블클릭 리포트
+    // Report double-click to AI
     if (window.clawmate.reportToAI) {
       window.clawmate.reportToAI('double_click', { position: pos });
     }
 
-    // 자율 모드: 더블클릭 = 특별 반응 (점프 + 기분좋음)
+    // Autonomous mode: double-click = special reaction (jump + excitement)
     if (AIController.isAutonomous()) {
       StateMachine.forceState('excited');
       PetEngine.jumpTo(
         pos.x + (Math.random() - 0.5) * 200,
         Math.max(100, pos.y - 150)
       );
-      Speech.show('우와! 더블클릭이다!');
+      Speech.show('Wow! A double-click!');
     }
 
     Memory.recordClick();
-    Memory.recordClick(); // 더블클릭 = 2회 클릭
+    Memory.recordClick(); // double-click = 2 clicks
     spawnHeartEffect();
     spawnStarEffect();
   }
@@ -178,14 +178,14 @@ const Interactions = (() => {
     const dist = Math.hypot(e.clientX - (pos.x + 32), e.clientY - (pos.y + 32));
 
     if (dist < 100) {
-      // 유저 반응 기록 — 커서 접근 = 관심 표현
+      // Record user reaction -- cursor approach = showing interest
       const curAction = StateMachine.getState();
       Memory.recordReaction(curAction, 'cursor_near');
 
-      // AI에 커서 접근 리포트
+      // Report cursor proximity to AI
       AIController.reportCursorNear(dist);
 
-      // AI 미연결 시: 자율 반응
+      // When AI disconnected: autonomous reaction
       if (AIController.isAutonomous()) {
         const state = StateMachine.getState();
         if (state === 'idle' || state === 'walking') {