@su-record/vibe 2.4.72 → 2.4.76

package/languages/swift-ios.md

@@ -1,32 +1,33 @@
-# 🍎 Swift + iOS 품질 규칙
+# Swift + iOS Quality Rules
 
-## 핵심 원칙 (core에서 상속)
+## Core Principles (inherited from core)
 
 ```markdown
-✅ 단일 책임 (SRP)
-✅ 중복 제거 (DRY)
-✅ 재사용성
-✅ 낮은 복잡도
-✅ 함수 ≤ 30줄
-✅ 중첩 ≤ 3단계
-✅ Cyclomatic complexity ≤ 10
+# Core Principles (inherited from core)
+Single Responsibility (SRP)
+No Duplication (DRY)
+Reusability
+Low Complexity
+Function <= 30 lines
+Nesting <= 3 levels
+Cyclomatic complexity <= 10
 ```
 
-## Swift/iOS 특화 규칙
+## Swift/iOS Specific Rules
 
-### 1. SwiftUI 기본 구조
+### 1. SwiftUI Basic Structure
 
 ```swift
-// ✅ View 구조
+// Good: View structure
 import SwiftUI
 
 struct UserProfileView: View {
-    // 1. 상태 및 바인딩
+    // 1. State and bindings
     @StateObject private var viewModel: UserProfileViewModel
     @State private var isEditing = false
     @Binding var selectedUser: User?
 
-    // 2. 환경 변수
+    // 2. Environment variables
     @Environment(\.dismiss) private var dismiss
     @EnvironmentObject private var authManager: AuthManager
 
@@ -34,14 +35,14 @@ struct UserProfileView: View {
     var body: some View {
         NavigationStack {
             content
-                .navigationTitle("프로필")
+                .navigationTitle("Profile")
                 .toolbar { toolbarContent }
                 .sheet(isPresented: $isEditing) { editSheet }
         }
         .task { await viewModel.loadUser() }
     }
 
-    // 4. 뷰 컴포넌트 분리
+    // 4. Separate view components
     @ViewBuilder
     private var content: some View {
         if viewModel.isLoading {
@@ -55,9 +56,9 @@ struct UserProfileView: View {
 
     private func userContent(_ user: User) -> some View {
         List {
-            Section("기본 정보") {
-                LabeledContent("이름", value: user.name)
-                LabeledContent("이메일", value: user.email)
+            Section("Basic Info") {
+                LabeledContent("Name", value: user.name)
+                LabeledContent("Email", value: user.email)
             }
         }
     }
@@ -65,7 +66,7 @@ struct UserProfileView: View {
     @ToolbarContentBuilder
     private var toolbarContent: some ToolbarContent {
         ToolbarItem(placement: .topBarTrailing) {
-            Button("편집") { isEditing = true }
+            Button("Edit") { isEditing = true }
         }
     }
 }
@@ -74,18 +75,18 @@ struct UserProfileView: View {
 ### 2. ViewModel (MVVM)
 
 ```swift
-// ✅ ViewModel with @Observable (iOS 17+)
+// Good: ViewModel with @Observable (iOS 17+)
 import Foundation
 import Observation
 
 @Observable
 final class UserProfileViewModel {
-    // 상태
+    // State
     private(set) var user: User?
     private(set) var isLoading = false
     private(set) var error: AppError?
 
-    // 의존성
+    // Dependencies
     private let userRepository: UserRepository
     private let userId: String
 
@@ -117,7 +118,7 @@ final class UserProfileViewModel {
     }
 }
 
-// ✅ ViewModel with ObservableObject (iOS 13+)
+// Good: ViewModel with ObservableObject (iOS 13+)
 import Combine
 
 final class UserListViewModel: ObservableObject {
@@ -161,10 +162,10 @@ final class UserListViewModel: ObservableObject {
 }
 ```
 
-### 3. Repository 패턴
+### 3. Repository Pattern
 
 ```swift
-// ✅ Protocol 정의
+// Good: Protocol definition
 protocol UserRepository {
     func fetchUsers() async throws -> [User]
     func fetchUser(id: String) async throws -> User
@@ -173,7 +174,7 @@ protocol UserRepository {
     func deleteUser(id: String) async throws
 }
 
-// ✅ 구현체
+// Good: Implementation
 final class DefaultUserRepository: UserRepository {
     private let apiClient: APIClient
     private let cache: CacheManager
@@ -184,18 +185,18 @@ final class DefaultUserRepository: UserRepository {
     }
 
     func fetchUser(id: String) async throws -> User {
-        // 캐시 확인
+        // Check cache
         if let cached: User = cache.get(key: "user_\(id)") {
             return cached
         }
 
-        // API 호출
+        // API call
         let user: User = try await apiClient.request(
             endpoint: .user(id: id),
             method: .get
         )
 
-        // 캐시 저장
+        // Save to cache
         cache.set(key: "user_\(id)", value: user, ttl: 300)
 
         return user
@@ -210,10 +211,10 @@ final class DefaultUserRepository: UserRepository {
 }
 ```
 
-### 4. 에러 처리
+### 4. Error Handling
 
 ```swift
-// ✅ 커스텀 에러 정의
+// Good: Custom error definition
 enum AppError: LocalizedError {
     case networkError(underlying: Error)
     case decodingError(underlying: Error)
@@ -225,17 +226,17 @@ enum AppError: LocalizedError {
     var errorDescription: String? {
         switch self {
         case .networkError:
-            return "네트워크 연결을 확인해주세요"
+            return "Please check your network connection"
         case .decodingError:
-            return "데이터를 처리할 수 없습니다"
+            return "Unable to process data"
         case .notFound(let resource, let id):
-            return "\(resource)을(를) 찾을 수 없습니다 (ID: \(id))"
+            return "\(resource) not found (ID: \(id))"
         case .unauthorized:
-            return "로그인이 필요합니다"
+            return "Login required"
         case .serverError(let message):
-            return "서버 오류: \(message)"
+            return "Server error: \(message)"
         case .unknown:
-            return "알 수 없는 오류가 발생했습니다"
+            return "An unknown error occurred"
         }
     }
 
@@ -256,7 +257,7 @@ enum AppError: LocalizedError {
     }
 }
 
-// ✅ Result 타입 활용
+// Good: Result type usage
 func loadData() async -> Result<User, AppError> {
     do {
         let user = try await repository.fetchUser(id: userId)
@@ -267,10 +268,10 @@ func loadData() async -> Result<User, AppError> {
 }
 ```
 
-### 5. 네트워킹 (async/await)
+### 5. Networking (async/await)
 
 ```swift
-// ✅ API 클라이언트
+// Good: API Client
 final class APIClient {
     static let shared = APIClient()
 
@@ -295,7 +296,7 @@ final class APIClient {
         request.httpMethod = method.rawValue
         request.setValue("application/json", forHTTPHeaderField: "Content-Type")
 
-        // 인증 토큰
+        // Auth token
         if let token = AuthManager.shared.accessToken {
             request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")
         }
@@ -324,7 +325,7 @@ final class APIClient {
     }
 }
 
-// ✅ Endpoint 정의
+// Good: Endpoint definition
 enum Endpoint {
     case users
     case user(id: String)
@@ -353,10 +354,10 @@ enum Endpoint {
 }
 ```
 
-### 6. 의존성 주입
+### 6. Dependency Injection
 
 ```swift
-// ✅ Environment를 통한 DI (SwiftUI)
+// Good: DI via Environment (SwiftUI)
 private struct UserRepositoryKey: EnvironmentKey {
     static let defaultValue: UserRepository = DefaultUserRepository()
 }
@@ -368,7 +369,7 @@ extension EnvironmentValues {
     }
 }
 
-// 사용
+// Usage
 struct ContentView: View {
     @Environment(\.userRepository) private var userRepository
 
@@ -377,7 +378,7 @@ struct ContentView: View {
     }
 }
 
-// ✅ Container 패턴
+// Good: Container pattern
 final class DIContainer {
     static let shared = DIContainer()
 
@@ -393,13 +394,13 @@ final class DIContainer {
 }
 ```
 
-### 7. 테스트
+### 7. Testing
 
 ```swift
 import XCTest
 @testable import MyApp
 
-// ✅ Mock Repository
+// Good: Mock Repository
 final class MockUserRepository: UserRepository {
     var fetchUsersResult: Result<[User], Error> = .success([])
     var fetchUserResult: Result<User, Error> = .failure(AppError.notFound(resource: "User", id: ""))
@@ -412,10 +413,10 @@ final class MockUserRepository: UserRepository {
         try fetchUserResult.get()
     }
 
-    // ... 다른 메서드
+    // ... other methods
 }
 
-// ✅ ViewModel 테스트
+// Good: ViewModel test
 final class UserListViewModelTests: XCTestCase {
     var sut: UserListViewModel!
     var mockRepository: MockUserRepository!
@@ -432,11 +433,11 @@ final class UserListViewModelTests: XCTestCase {
         super.tearDown()
     }
 
-    func test_loadUsers_성공시_users가_업데이트된다() async {
+    func test_loadUsers_onSuccess_updatesUsers() async {
         // Given
         let expectedUsers = [
-            User(id: "1", name: "테스트1", email: "test1@example.com"),
-            User(id: "2", name: "테스트2", email: "test2@example.com")
+            User(id: "1", name: "Test1", email: "test1@example.com"),
+            User(id: "2", name: "Test2", email: "test2@example.com")
         ]
         mockRepository.fetchUsersResult = .success(expectedUsers)
 
@@ -448,30 +449,30 @@ final class UserListViewModelTests: XCTestCase {
         XCTAssertFalse(sut.isLoading)
     }
 
-    func test_filteredUsers_검색어가_있으면_필터링된다() {
+    func test_filteredUsers_withSearchText_filtersCorrectly() {
         // Given
         sut.users = [
-            User(id: "1", name: "홍길동", email: "hong@example.com"),
-            User(id: "2", name: "김철수", email: "kim@example.com")
+            User(id: "1", name: "John Doe", email: "john@example.com"),
+            User(id: "2", name: "Jane Smith", email: "jane@example.com")
         ]
 
         // When
-        sut.searchText = "홍"
+        sut.searchText = "John"
 
         // Then
         XCTAssertEqual(sut.filteredUsers.count, 1)
-        XCTAssertEqual(sut.filteredUsers.first?.name, "홍길동")
+        XCTAssertEqual(sut.filteredUsers.first?.name, "John Doe")
     }
 }
 ```
 
-## 파일 구조
+## File Structure
 
-```
+```text
 Project/
 ├── App/
-│   ├── ProjectApp.swift         # 앱 진입점
-│   └── DIContainer.swift        # 의존성 컨테이너
+│   ├── ProjectApp.swift         # App entry point
+│   └── DIContainer.swift        # Dependency container
 ├── Features/
 │   ├── Auth/
 │   │   ├── Views/
@@ -504,13 +505,13 @@ Project/
     └── UITests/
 ```
 
-## 체크리스트
+## Checklist
 
-- [ ] @Observable 또는 @ObservableObject 사용
-- [ ] MVVM 패턴 준수
-- [ ] async/await로 비동기 처리
-- [ ] Protocol로 의존성 추상화
-- [ ] @MainActor로 UI 업데이트 보장
-- [ ] LocalizedError로 에러 메시지 정의
-- [ ] @ViewBuilder로 조건부 뷰 분리
-- [ ] 테스트 가능한 구조 (Mock 주입)
+- [ ] Use @Observable or @ObservableObject
+- [ ] Follow MVVM pattern
+- [ ] Handle async with async/await
+- [ ] Abstract dependencies with Protocol
+- [ ] Ensure UI updates with @MainActor
+- [ ] Define error messages with LocalizedError
+- [ ] Separate conditional views with @ViewBuilder
+- [ ] Testable structure (Mock injection)

package/languages/typescript-electron.md

@@ -1,45 +1,44 @@
-# ⚡ TypeScript + Electron 품질 규칙
+# TypeScript + Electron Quality Rules
 
-## 핵심 원칙 (core에서 상속)
+## Core Principles (inherited from core)
 
 ```markdown
-✅ 단일 책임 (SRP)
-✅ 중복 제거 (DRY)
-✅ 재사용성
-✅ 낮은 복잡도
-✅ 함수 ≤ 30줄
-✅ 중첩 ≤ 3단계
-✅ Cyclomatic complexity ≤ 10
+# Core Principles (inherited from core)
+Single Responsibility (SRP)
+No Duplication (DRY)
+Reusability
+Low Complexity
+Function <= 30 lines
+Nesting <= 3 levels
+Cyclomatic complexity <= 10
 ```
 
-## Electron 아키텍처 이해
+## Electron Architecture Understanding
 
-```
-┌─────────────────────────────────────────────┐
-│  Main Process (Node.js)                     │
-│  - 앱 생명주기 관리                          │
-│  - 시스템 API (파일, 네트워크)               │
-│  - BrowserWindow 생성/관리                  │
-├─────────────────────────────────────────────┤
-│  Preload Script (격리된 컨텍스트)            │
-│  - contextBridge로 API 노출                 │
-│  - Main ↔ Renderer 브릿지                   │
-├─────────────────────────────────────────────┤
-│  Renderer Process (Chromium)                │
-│  - UI 렌더링 (React/Vue/etc)                │
-│  - window.electronAPI 사용                  │
-└─────────────────────────────────────────────┘
+```text
+Main Process (Node.js)
+- App lifecycle management
+- System APIs (file, network)
+- BrowserWindow creation/management
+
+Preload Script (Isolated Context)
+- Expose APIs via contextBridge
+- Main <-> Renderer bridge
+
+Renderer Process (Chromium)
+- UI rendering (React/Vue/etc)
+- Use window.electronAPI
 ```
 
-## TypeScript/Electron 특화 규칙
+## TypeScript/Electron Specific Rules
 
-### 1. 프로세스 분리 필수
+### 1. Process Separation Required
 
 ```typescript
-// ❌ Renderer에서 직접 Node.js 사용 (보안 취약)
-// nodeIntegration: true 금지!
+// Bad: Direct Node.js usage in Renderer (security vulnerability)
+// nodeIntegration: true is prohibited!
 
-// ✅ Main Process (main.ts)
+// Good: Main Process (main.ts)
 import { app, BrowserWindow, ipcMain } from 'electron';
 import path from 'path';
 
@@ -49,9 +48,9 @@ function createWindow(): BrowserWindow {
     height: 600,
     webPreferences: {
       preload: path.join(__dirname, 'preload.js'),
-      contextIsolation: true,    // 필수!
-      nodeIntegration: false,    // 필수!
-      sandbox: true              // 권장
+      contextIsolation: true,    // Required!
+      nodeIntegration: false,    // Required!
+      sandbox: true              // Recommended
     }
   });
 
@@ -62,13 +61,13 @@ function createWindow(): BrowserWindow {
 app.whenReady().then(createWindow);
 ```
 
-### 2. Preload Script 패턴
+### 2. Preload Script Pattern
 
 ```typescript
 // preload.ts
 import { contextBridge, ipcRenderer } from 'electron';
 
-// ✅ 타입 정의
+// Good: Type definition
 interface ElectronAPI {
   readFile: (path: string) => Promise<string>;
   writeFile: (path: string, content: string) => Promise<void>;
@@ -76,7 +75,7 @@ interface ElectronAPI {
   platform: NodeJS.Platform;
 }
 
-// ✅ 안전하게 API 노출
+// Good: Safely expose API
 contextBridge.exposeInMainWorld('electronAPI', {
   readFile: (path: string) => ipcRenderer.invoke('read-file', path),
   writeFile: (path: string, content: string) =>
@@ -89,7 +88,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
   platform: process.platform
 } satisfies ElectronAPI);
 
-// ✅ 타입 선언 (renderer에서 사용)
+// Good: Type declaration (for use in renderer)
 declare global {
   interface Window {
     electronAPI: ElectronAPI;
@@ -97,7 +96,7 @@ declare global {
 }
 ```
 
-### 3. IPC 통신 타입 안전성
+### 3. IPC Communication Type Safety
 
 ```typescript
 // shared/ipc-types.ts
@@ -120,7 +119,7 @@ export interface AppInfo {
 import { ipcMain } from 'electron';
 import fs from 'fs/promises';
 
-// ✅ 타입 안전한 핸들러
+// Good: Type-safe handler
 ipcMain.handle('read-file', async (_event, path: string): Promise<string> => {
   return fs.readFile(path, 'utf-8');
 });
@@ -141,12 +140,12 @@ ipcMain.handle('get-app-info', async (): Promise<AppInfo> => {
 });
 ```
 
-### 4. Renderer에서 IPC 사용
+### 4. IPC Usage in Renderer
 
 ```typescript
 // renderer/hooks/useElectron.ts
 
-// ✅ Custom Hook
+// Good: Custom Hook
 function useFileReader() {
   const [content, setContent] = useState<string | null>(null);
   const [loading, setLoading] = useState(false);
@@ -171,7 +170,7 @@ function useFileReader() {
   return { content, loading, error, readFile };
 }
 
-// ✅ 이벤트 구독 Hook
+// Good: Event subscription Hook
 function useFileWatcher(onChanged: (path: string) => void) {
   useEffect(() => {
     const unsubscribe = window.electronAPI.onFileChanged(onChanged);
@@ -180,13 +179,13 @@ function useFileWatcher(onChanged: (path: string) => void) {
 }
 ```
 
-### 5. 창 관리
+### 5. Window Management
 
 ```typescript
 // main.ts
 import { BrowserWindow, screen } from 'electron';
 
-// ✅ 창 상태 저장/복원
+// Good: Save/restore window state
 interface WindowState {
   x?: number;
   y?: number;
@@ -214,7 +213,7 @@ function createWindowWithState(): BrowserWindow {
     win.maximize();
   }
 
-  // 상태 변경 시 저장
+  // Save state on change
   win.on('close', () => {
     saveWindowState({
       ...win.getBounds(),
@@ -225,7 +224,7 @@ function createWindowWithState(): BrowserWindow {
   return win;
 }
 
-// ✅ 다중 창 관리
+// Good: Multiple window management
 const windows = new Map<string, BrowserWindow>();
 
 function getOrCreateWindow(id: string): BrowserWindow {
@@ -242,12 +241,12 @@ function getOrCreateWindow(id: string): BrowserWindow {
 }
 ```
 
-### 6. 메뉴 구성
+### 6. Menu Configuration
 
 ```typescript
 import { Menu, MenuItemConstructorOptions } from 'electron';
 
-// ✅ 플랫폼별 메뉴
+// Good: Platform-specific menu
 function createMenu(): Menu {
   const isMac = process.platform === 'darwin';
 
@@ -283,18 +282,18 @@ function createMenu(): Menu {
 }
 ```
 
-### 7. 자동 업데이트
+### 7. Auto Update
 
 ```typescript
 import { autoUpdater } from 'electron-updater';
 
-// ✅ 자동 업데이트 설정
+// Good: Auto update setup
 function setupAutoUpdater(): void {
   autoUpdater.autoDownload = false;
   autoUpdater.autoInstallOnAppQuit = true;
 
   autoUpdater.on('update-available', (info) => {
-    // 사용자에게 알림
+    // Notify user
     dialog.showMessageBox({
       type: 'info',
       title: 'Update Available',
@@ -320,15 +319,15 @@ function setupAutoUpdater(): void {
     });
   });
 
-  // 앱 시작 시 업데이트 확인
+  // Check for updates on app start
   autoUpdater.checkForUpdates();
 }
 ```
 
-### 8. 보안 체크리스트
+### 8. Security Checklist
 
 ```typescript
-// ✅ 보안 설정 검증
+// Good: Validate security settings
 function validateSecuritySettings(win: BrowserWindow): void {
   const webPrefs = win.webContents.getWebPreferences();
 
@@ -343,9 +342,9 @@ function validateSecuritySettings(win: BrowserWindow): void {
   }
 }
 
-// ✅ 외부 링크 처리
+// Good: Handle external links
 win.webContents.setWindowOpenHandler(({ url }) => {
-  // 외부 URL은 시스템 브라우저에서 열기
+  // Open external URLs in system browser
   if (url.startsWith('https://')) {
     shell.openExternal(url);
   }
@@ -353,9 +352,9 @@ win.webContents.setWindowOpenHandler(({ url }) => {
 });
 ```
 
-## 폴더 구조 권장
+## Recommended Folder Structure
 
-```
+```text
 my-electron-app/
 ├── src/
 │   ├── main/               # Main Process
@@ -368,13 +367,13 @@ my-electron-app/
 │   │   ├── components/
 │   │   ├── hooks/
 │   │   └── App.tsx
-│   └── shared/             # 공유 타입
+│   └── shared/             # Shared types
 │       └── ipc-types.ts
 ├── electron-builder.yml
 └── package.json
 ```
 
-## 빌드 설정 (electron-builder)
+## Build Configuration (electron-builder)
 
 ```yaml
 # electron-builder.yml
@@ -394,14 +393,14 @@ linux:
   target: [AppImage, deb]
 ```
 
-## 체크리스트
-
-- [ ] `contextIsolation: true` 설정
-- [ ] `nodeIntegration: false` 설정
-- [ ] Preload script로만 API 노출
-- [ ] IPC 채널 타입 정의
-- [ ] 외부 링크 처리 (setWindowOpenHandler)
-- [ ] 창 상태 저장/복원
-- [ ] 자동 업데이트 설정
-- [ ] 플랫폼별 메뉴 구성
-- [ ] CSP 헤더 설정
+## Checklist
+
+- [ ] `contextIsolation: true` configured
+- [ ] `nodeIntegration: false` configured
+- [ ] Expose APIs only through preload script
+- [ ] Define IPC channel types
+- [ ] Handle external links (setWindowOpenHandler)
+- [ ] Save/restore window state
+- [ ] Auto update setup
+- [ ] Platform-specific menu configuration
+- [ ] CSP header configured