clawmate 1.4.0 → 1.4.2

package/main/autostart.js

@@ -1,12 +1,12 @@
 /**
- * 시스템 시작 시 ClawMate 자동 실행 등록
+ * Register ClawMate auto-start on system boot
  *
- * Windows: 레지스트리 Run 키
+ * Windows: Registry Run key
  * macOS: LaunchAgent plist
- * Linux: ~/.config/autostart/ 디렉토리에 .desktop 파일 생성
+ * Linux: Create .desktop file in ~/.config/autostart/ directory
  *
- * AI가 나중에 켜져도, ClawMate는 이미 돌고 있어서 바로 연결됨.
- * ClawMate가 먼저 혼자 자율 모드로 돌다가 → AI 연결되면 AI 모드 전환.
+ * Even if AI starts later, ClawMate is already running for immediate connection.
+ * ClawMate runs in autonomous mode first -> switches to AI mode when AI connects.
  */
 const { app } = require('electron');
 const fs = require('fs');
@@ -53,7 +53,7 @@ function enableAutoStart() {
   }
   app.setLoginItemSettings({
     openAtLogin: true,
-    openAsHidden: true,  // 창 없이 백그라운드 시작
+    openAsHidden: true,  // Start in background without window
     path: process.execPath,
     args: [path.resolve(__dirname, '..')],
   });

package/main/desktop-path.js

@@ -3,8 +3,8 @@ const path = require('path');
 const { execSync } = require('child_process');
 
 /**
- * OS별 바탕화면 경로 탐지
- * Windows: PowerShell로 정확한 경로 탐지 (OneDrive 등 대응)
+ * Detect desktop path per OS
+ * Windows: Accurate path detection via PowerShell (handles OneDrive, etc.)
  * macOS: ~/Desktop
  */
 function getDesktopPath() {
@@ -18,10 +18,10 @@ function getDesktopPath() {
       ).trim();
       if (result && result.length > 0) return result;
     } catch {
-      // PowerShell 실패 시 폴백
+      // Fallback on PowerShell failure
     }
 
-    // 환경 변수 기반 폴백
+    // Environment variable based fallback
     const userProfile = process.env.USERPROFILE || os.homedir();
     return path.join(userProfile, 'Desktop');
   }

package/main/file-command-parser.js

@@ -1,20 +1,20 @@
 /**
- * 파일 조작 명령 파서
+ * File operation command parser
  *
- * 한국어/영어 자연어를 파싱하여 파일 조작 의도를 추출한다.
- * 텔레그램 메시지에서 파일 이동, 정리 등의 명령을 감지.
+ * Parses Korean/English natural language to extract file operation intent.
+ * Detects file move, organize, etc. commands from Telegram messages.
  *
- * 지원 패턴:
- *   - "바탕화면의 .md 파일을 tata 폴더에 넣어줘"
- *   - "스크린샷 폴더에 .png 정리해"
- *   - "바탕화면 정리해"
+ * Supported patterns:
+ *   - "바탕화면의 .md 파일을 tata 폴더에 넣어줘" (Korean: move .md files from desktop to tata folder)
+ *   - "스크린샷 폴더에 .png 정리해" (Korean: organize .png into screenshots folder)
+ *   - "바탕화면 정리해" (Korean: clean up desktop)
  *   - "move .txt files to docs folder"
  */
 
 const os = require('os');
 const path = require('path');
 
-// 알려진 소스 경로 별칭 (한국어 + 영어)
+// Known source path aliases (Korean + English)
 const SOURCE_ALIASES = {
   '바탕화면': () => _getDesktopPath(),
   '데스크탑': () => _getDesktopPath(),
@@ -27,7 +27,7 @@ const SOURCE_ALIASES = {
   'documents': () => path.join(os.homedir(), 'Documents'),
 };
 
-// 행동 명령 키워드 → 액션 매핑
+// Action command keywords -> action mapping
 const ACTION_KEYWORDS = {
   '점프': 'jumping',
   '점프해': 'jumping',
@@ -58,24 +58,24 @@ const ACTION_KEYWORDS = {
   'rappel': 'rappelling',
 };
 
-// 파일 조작 감지 키워드
+// File operation detection patterns
 const FILE_OP_PATTERNS = [
-  // "~의 .ext 파일을 ~폴더에 넣어줘/옮겨줘/이동해"
+  // Korean: "~의 .ext 파일을 ~폴더에 넣어줘/옮겨줘/이동해" (move .ext files from ~ to ~ folder)
   /(?:(.+?)(?:의|에서|에 있는)\s+)?([.\w*]+)\s*파일(?:을|들을)?\s+(.+?)(?:폴더)?(?:에|으로)\s*(?:넣어|옮겨|이동|정리|보내)/,
-  // "~폴더에 .ext 정리해"
+  // Korean: "~폴더에 .ext 정리해" (organize .ext into ~ folder)
   /(.+?)(?:폴더)?(?:에|으로)\s+([.\w*]+)\s*(?:파일\s*)?(?:정리|넣어|옮겨|이동)/,
-  // "바탕화면 정리해"
+  // Korean: "바탕화면 정리해" (clean up desktop)
   /(.+?)\s*(?:정리|청소|깔끔하게)\s*(?:해|해줘|하자|좀)/,
-  // 영어: "move .ext files to folder"
+  // English: "move .ext files to folder"
   /move\s+([.\w*]+)\s+files?\s+(?:to|into)\s+(\S+)/i,
-  // 영어: "clean up desktop"
+  // English: "clean up desktop"
   /clean\s*(?:up)?\s+(\S+)/i,
-  // 영어: "organize desktop"
+  // English: "organize desktop"
   /organize\s+(\S+)/i,
 ];
 
 /**
- * 데스크톱 경로 가져오기 (file-ops와 동일 로직)
+ * Get desktop path (same logic as file-ops)
  */
 function _getDesktopPath() {
   try {
@@ -87,9 +87,9 @@ function _getDesktopPath() {
 }
 
 /**
- * 소스 별칭을 실제 경로로 변환
- * @param {string} alias - 소스 별칭 (예: "바탕화면")
- * @returns {string|null} 실제 경로 또는 null
+ * Resolve source alias to actual path
+ * @param {string} alias - Source alias (e.g., "desktop", "바탕화면")
+ * @returns {string|null} Actual path or null
  */
 function resolveSource(alias) {
   if (!alias) return null;
@@ -103,8 +103,8 @@ function resolveSource(alias) {
 }
 
 /**
- * 자동 분류 확장자 → 폴더명 매핑
- * "바탕화면 정리해" 같은 범용 명령에서 사용
+ * Auto-categorize extension -> folder name mapping
+ * Used in generic commands like "clean up desktop"
  */
 const AUTO_CATEGORIES = {
   '.png': '이미지',
@@ -141,8 +141,8 @@ const AUTO_CATEGORIES = {
 };
 
 /**
- * 메시지에서 행동 명령을 감지
- * @param {string} text - 사용자 메시지
+ * Detect action commands from message
+ * @param {string} text - User message
  * @returns {{ type: 'action', action: string }|null}
  */
 function parseActionCommand(text) {
@@ -158,15 +158,15 @@ function parseActionCommand(text) {
 }
 
 /**
- * 메시지에서 파일 조작 명령을 감지
- * @param {string} text - 사용자 메시지
+ * Detect file operation commands from message
+ * @param {string} text - User message
  * @returns {{ type: 'smart_file_op', source: string, filter: string, target: string, autoCategory: boolean }|null}
  */
 function parseFileCommand(text) {
   if (!text) return null;
   const trimmed = text.trim();
 
-  // 패턴 1: "바탕화면의 .md 파일을 tata 폴더에 넣어줘"
+  // Pattern 1: "바탕화면의 .md 파일을 tata 폴더에 넣어줘" (Korean: move files)
   const pattern1 = /(?:(.+?)(?:의|에서|에 있는)\s+)?([.\w*]+)\s*파일(?:을|들을)?\s+(.+?)(?:\s*폴더)?(?:에|으로)\s*(?:넣어|옮겨|이동|정리|보내)/;
   let match = trimmed.match(pattern1);
   if (match) {
@@ -184,7 +184,7 @@ function parseFileCommand(text) {
     };
   }
 
-  // 패턴 2: "스크린샷 폴더에 .png 정리해"
+  // Pattern 2: "스크린샷 폴더에 .png 정리해" (Korean: organize into folder)
   const pattern2 = /(.+?)(?:\s*폴더)?(?:에|으로)\s+([.\w*]+)\s*(?:파일\s*)?(?:정리|넣어|옮겨|이동)/;
   match = trimmed.match(pattern2);
   if (match) {
@@ -200,7 +200,7 @@ function parseFileCommand(text) {
     };
   }
 
-  // 패턴 3: "바탕화면 정리해" (자동 분류)
+  // Pattern 3: "바탕화면 정리해" (Korean: auto-categorize cleanup)
   const pattern3 = /(.+?)\s*(?:정리|청소|깔끔하게)\s*(?:해|해줘|하자|좀)?$/;
   match = trimmed.match(pattern3);
   if (match) {
@@ -217,7 +217,7 @@ function parseFileCommand(text) {
     }
   }
 
-  // 패턴 4 (영어): "move .txt files to docs"
+  // Pattern 4 (English): "move .txt files to docs"
   const pattern4 = /move\s+([.\w*]+)\s+files?\s+(?:to|into)\s+(\S+)/i;
   match = trimmed.match(pattern4);
   if (match) {
@@ -233,7 +233,7 @@ function parseFileCommand(text) {
     };
   }
 
-  // 패턴 5 (영어): "clean up desktop" / "organize desktop"
+  // Pattern 5 (English): "clean up desktop" / "organize desktop"
   const pattern5 = /(?:clean\s*(?:up)?|organize)\s+(\S+)/i;
   match = trimmed.match(pattern5);
   if (match) {
@@ -254,15 +254,15 @@ function parseFileCommand(text) {
 }
 
 /**
- * 캐릭터 변경 명령 감지
- * @param {string} text - 사용자 메시지
+ * Detect character change commands
+ * @param {string} text - User message
  * @returns {{ type: 'character_change', concept: string }|null}
  */
 function parseCharacterCommand(text) {
   if (!text) return null;
   const trimmed = text.trim();
 
-  // 한국어 캐릭터 변경 패턴
+  // Korean character change patterns
   const krPatterns = [
     /(?:캐릭터|펫|모습|외형|외모)(?:를|을)?\s*(.+?)(?:로|으로)\s*(?:바꿔|변경|변신|만들어|바꿀래|바꾸고|바꿔줘|변경해|만들어줘)/,
     /(.+?)(?:로|으로)\s*(?:캐릭터|펫|모습|외형)\s*(?:바꿔|변경|변신|변경해|바꿔줘)/,
@@ -276,7 +276,7 @@ function parseCharacterCommand(text) {
     }
   }
 
-  // 영어 캐릭터 변경 패턴
+  // English character change patterns
   const enPatterns = [
     /(?:change|switch|transform)\s+(?:character|pet|look)\s+(?:to|into)\s+(.+)/i,
     /(?:make|create|generate)\s+(?:a\s+)?(.+?)\s+(?:character|pet)/i,
@@ -293,25 +293,25 @@ function parseCharacterCommand(text) {
 }
 
 /**
- * 메시지 종합 파싱: 캐릭터 변경 > 파일 조작 > 행동 명령 > 일반 대화 순으로 판별
- * @param {string} text - 사용자 메시지
+ * Comprehensive message parsing: character change > file operation > action command > general chat
+ * @param {string} text - User message
  * @returns {{ type: string, ... }}
  */
 /**
- * 모드/설정 변경 명령 감지
- * @param {string} text - 사용자 메시지
+ * Detect mode/setting change commands
+ * @param {string} text - User message
  * @returns {{ type: 'mode_change', mode: string }|{ type: 'setting', key, value }|null}
  */
 function parseSettingCommand(text) {
   if (!text) return null;
   const t = text.trim().toLowerCase();
 
-  // 모드 변경
+  // Mode change
   if (/(?:펫|pet)\s*모드/.test(t)) return { type: 'mode_change', mode: 'pet' };
   if (/(?:인카|인격|incarnation|claw)\s*모드/.test(t)) return { type: 'mode_change', mode: 'incarnation' };
   if (/둘\s*다\s*모드|both\s*mode/i.test(t)) return { type: 'mode_change', mode: 'both' };
 
-  // 캐릭터 프리셋 선택 (트레이 프리셋과 동일)
+  // Character preset selection (same as tray presets)
   const presetMap = {
     '파란|파랑|blue': 'blue', '초록|green': 'green', '보라|purple': 'purple',
     '골드|금색|gold': 'gold', '핑크|pink': 'pink',
@@ -329,23 +329,23 @@ function parseSettingCommand(text) {
 }
 
 function parseMessage(text) {
-  // 0순위: 설정/모드 변경 명령
+  // Priority 0: setting/mode change commands
   const settingCmd = parseSettingCommand(text);
   if (settingCmd) return settingCmd;
 
-  // 1순위: 캐릭터 변경 명령 (AI 생성)
+  // Priority 1: character change commands (AI generation)
   const charCmd = parseCharacterCommand(text);
   if (charCmd) return charCmd;
 
-  // 2순위: 파일 조작 명령
+  // Priority 2: file operation commands
   const fileCmd = parseFileCommand(text);
   if (fileCmd) return fileCmd;
 
-  // 3순위: 행동 명령
+  // Priority 3: action commands
   const actionCmd = parseActionCommand(text);
   if (actionCmd) return actionCmd;
 
-  // 4순위: 일반 대화 (speak)
+  // Priority 4: general chat (speak)
   return { type: 'speak', text };
 }
 

package/main/file-ops.js

@@ -4,14 +4,14 @@ const { getDesktopPath } = require('./desktop-path');
 const manifest = require('./manifest');
 
 /**
- * 바탕화면 파일 이동 시스템 (안전장치 포함)
+ * Desktop file move system (with safety measures)
  *
- * 안전 규칙:
- * - 세션당 최대 3개 파일만 이동
- * - 이동 간 최소 5분 쿨다운
- * - 위험한 확장자 제외
- * - 100MB 이상 파일 제외
- * - 바탕화면 폴더 내에서만 위치 변경
+ * Safety rules:
+ * - Max 3 files moved per session
+ * - Min 5 minute cooldown between moves
+ * - Dangerous extensions excluded
+ * - Files over 100MB excluded
+ * - Position changes only within desktop folder
  */
 
 const MAX_FILES_PER_SESSION = 3;
@@ -26,7 +26,7 @@ let sessionMoveCount = 0;
 let lastMoveTime = 0;
 
 /**
- * 바탕화면 파일 목록 가져오기 (안전한 파일만)
+ * Get desktop file list (safe files only)
  */
 async function getDesktopFiles() {
   const desktop = getDesktopPath();
@@ -60,49 +60,49 @@ async function getDesktopFiles() {
 }
 
 /**
- * 바탕화면 내에서 파일 이름 변경(위치 변경 시뮬레이션)
- * 실제로는 바탕화면 폴더 안에서만 이동 가능
- * newPosition은 렌더러에서 전달한 좌표 (로그용)
+ * Rename file on desktop (simulates position change)
+ * Actually only moves within desktop folder
+ * newPosition is coordinates from renderer (for logging)
  */
 async function moveFile(fileName, newPosition) {
-  // 안전장치 체크
+  // Safety check
   if (sessionMoveCount >= MAX_FILES_PER_SESSION) {
-    return { success: false, error: '세션당 이동 한도(3개) 초과' };
+    return { success: false, error: 'Session move limit (3) exceeded' };
   }
 
   const now = Date.now();
   if (now - lastMoveTime < COOLDOWN_MS && lastMoveTime > 0) {
     const remaining = Math.ceil((COOLDOWN_MS - (now - lastMoveTime)) / 1000);
-    return { success: false, error: `쿨다운 중 (${remaining}초 남음)` };
+    return { success: false, error: `Cooldown active (${remaining}s remaining)` };
   }
 
   const desktop = getDesktopPath();
   const filePath = path.join(desktop, fileName);
 
-  // 파일 존재 확인
+  // Check file exists
   try {
     await fs.promises.access(filePath);
   } catch {
-    return { success: false, error: '파일을 찾을 수 없음' };
+    return { success: false, error: 'File not found' };
   }
 
-  // 확장자 체크
+  // Extension check
   const ext = path.extname(fileName).toLowerCase();
   if (EXCLUDED_EXTS.has(ext)) {
-    return { success: false, error: '보호된 파일 유형' };
+    return { success: false, error: 'Protected file type' };
   }
 
-  // 크기 체크
+  // Size check
   try {
     const stat = await fs.promises.stat(filePath);
     if (stat.size > MAX_FILE_SIZE) {
-      return { success: false, error: '파일 크기 초과 (100MB)' };
+      return { success: false, error: 'File size exceeded (100MB)' };
     }
   } catch {
-    return { success: false, error: '파일 정보 읽기 실패' };
+    return { success: false, error: 'Failed to read file info' };
   }
 
-  // 이동 기록 (바탕화면 내부 이동이므로 실제 파일시스템 위치는 동일)
+  // Record move (filesystem location stays the same since it's within desktop)
   const entry = manifest.addEntry({
     fileName,
     originalPath: filePath,
@@ -117,19 +117,19 @@ async function moveFile(fileName, newPosition) {
 }
 
 /**
- * 단일 파일 이동 되돌리기
+ * Undo single file move
  */
 async function undoFileMove(moveId) {
   const entry = manifest.markRestored(moveId);
   if (!entry) {
-    return { success: false, error: '이동 기록을 찾을 수 없음' };
+    return { success: false, error: 'Move record not found' };
   }
-  // 실제 파일 위치는 바탕화면 내에서만 변경되므로 기록만 업데이트
+  // Only update record since actual file location only changes within desktop
   return { success: true };
 }
 
 /**
- * 모든 파일 이동 되돌리기
+ * Undo all file moves
  */
 async function undoAllMoves() {
   const count = manifest.markAllRestored();
@@ -137,7 +137,7 @@ async function undoAllMoves() {
 }
 
 /**
- * 파일 이동 이력 가져오기
+ * Get file move history
  */
 async function getFileManifest() {
   return manifest.getAll();

package/main/index.js

@@ -31,7 +31,7 @@ function createMainWindow() {
     },
   });
 
-  // 클릭 통과 — 펫 영역만 클릭 가능하도록 렌더러에서 제어
+  // Click-through — renderer controls which pet areas are clickable
   mainWindow.setIgnoreMouseEvents(true, { forward: true });
 
   mainWindow.loadFile(path.join(__dirname, '..', 'renderer', 'index.html'));
@@ -69,26 +69,26 @@ function createLauncherWindow() {
 }
 
 /**
- * AI Bridge 시작 — AI 에이전트가 접속하면 펫을 조종
+ * Start AI Bridge -- AI agent connects to control the pet
  */
 function startAIBridge(win) {
   aiBridge = new AIBridge();
   aiBridge.start();
 
-  // AI → ClawMate 명령을 렌더러에 전달
+  // Forward AI -> ClawMate commands to renderer
   const commandTypes = [
     'action', 'move', 'emote', 'speak', 'think',
     'carry_file', 'drop_file', 'set_mode', 'evolve',
     'accessorize', 'ai_decision',
-    // 공간 이동 명령 (펫이 집처럼 돌아다니기)
+    // Spatial movement commands (pet roams like it's home)
     'jump_to', 'rappel', 'release_thread', 'move_to_center', 'walk_on_window',
-    // 커스텀 이동 패턴
+    // Custom movement patterns
     'register_movement', 'custom_move', 'stop_custom_move', 'list_movements',
-    // 스마트 파일 조작 (텔레그램/AI에서 트리거한 파일 이동 애니메이션)
+    // Smart file operations (file move animations triggered by Telegram/AI)
     'smart_file_op',
-    // 캐릭터 커스터마이징 (텔레그램에서 AI 생성)
+    // Character customization (AI-generated via Telegram)
     'set_character', 'reset_character',
-    // 인격체 전환 (Incarnation 모드)
+    // Persona switching (Incarnation mode)
     'set_persona',
   ];
 
@@ -100,19 +100,19 @@ function startAIBridge(win) {
     });
   });
 
-  // AI 윈도우 위치 정보 요청 처리
+  // Handle AI window position info request
   aiBridge.on('query_windows', async () => {
     try {
       const { getWindowPositions } = require('./platform');
       const windows = await getWindowPositions();
       aiBridge.send('window_positions', { windows });
     } catch (err) {
-      console.error('[AI Bridge] 윈도우 목록 실패:', err.message);
+      console.error('[AI Bridge] Window list failed:', err.message);
       aiBridge.send('window_positions', { windows: [] });
     }
   });
 
-  // AI 화면 캡처 요청 처리 (main process에서 직접 캡처)
+  // Handle AI screen capture request (captured directly in main process)
   aiBridge.on('query_screen', async () => {
     try {
       const primaryDisplay = screen.getPrimaryDisplay();
@@ -133,11 +133,11 @@ function startAIBridge(win) {
         );
       }
     } catch (err) {
-      console.error('[AI Bridge] 화면 캡처 실패:', err.message);
+      console.error('[AI Bridge] Screen capture failed:', err.message);
     }
   });
 
-  // 연결/해제 이벤트
+  // Connection/disconnection events
   aiBridge.on('connected', () => {
     if (win && !win.isDestroyed()) {
       win.webContents.send('ai-connected');
@@ -159,22 +159,22 @@ app.whenReady().then(() => {
   const bridge = startAIBridge(win);
   setupTray(win, bridge);
 
-  // 텔레그램 봇 초기화 (토큰 없으면 조용히 무시)
+  // Initialize Telegram bot (silently ignored if no token)
   telegramBot = new TelegramBot(bridge);
 
-  // 최초 설치 시 자동 시작 등록
+  // Register auto-start on first install
   const { enableAutoStart, isAutoStartEnabled } = require('./autostart');
   if (!isAutoStartEnabled()) {
     enableAutoStart();
   }
 
-  // 자동 업데이트 확인 (빌드된 앱에서만 동작)
+  // Auto-update check (only works in packaged app)
   const { checkForUpdates } = require('./updater');
   checkForUpdates();
 });
 
 app.on('window-all-closed', () => {
-  // 트레이에서 계속 실행
+  // Keep running in tray
 });
 
 app.on('before-quit', () => {