Phase 7~8 구현: 테스트 + 빌드 + CI/CD + SoundEffect + AutoLaunch + UI 리디자인

- vitest 41개 단위 테스트 (HistoryService, DictionaryService, CustomInstructionService, VoiceModeService, D3ROError)
- electron-builder.yml (NSIS, asarUnpack, extraResources)
- .gitlab-ci.yml (lint, typecheck, test, build, release)
- SoundEffectService: WAV 프리로드 + PowerShell 재생 + VoiceMode 연동
- AutoLaunchService: app.setLoginItemSettings + ConfigService 동기화
- TextInsertService: 간이 삽입 검증 (EditMonitor 경량)
- 번들링 인프라: SoX 다운로드 스크립트, PyInstaller 빌드, 경로 해상도 유틸
- AudioCaptureService/LocalSTTService: 번들 경로 자동 감지
- 08-design-system.md 기반 MUI 테마 (다크+라이트+auto 테마 시스템)
- 전체 UI 컴포넌트 리디자인: AppLayout, Dashboard, StatusBar, History, Dictionary, Commands, Settings
- 효과음 WAV 생성: recording-start, recording-stop, error
- EPIPE 에러 핸들링 추가

tests/main/services/VoiceModeService.test.ts

@@ -0,0 +1,204 @@
+// tests/main/services/VoiceModeService.test.ts
+// 상태 머신 전이 + 이중 조건 플러시 + accidentalPress 테스트
+
+import { describe, it, expect, beforeEach, vi } from 'vitest'
+import { RecognitionState, AudioState } from '../../../src/shared/types'
+import { TIMING } from '../../../src/shared/constants'
+
+// 모든 하위 서비스 모킹
+vi.mock('../../../src/main/services/LoggerService', () => ({
+  getLogger: () => ({
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+    debug: vi.fn()
+  })
+}))
+
+const mockSTT = {
+  initialize: vi.fn(() => Promise.resolve()),
+  transcribe: vi.fn(() =>
+    Promise.resolve({ text: '테스트 전사', segments: [], language: 'ko', duration: 2, processingTime: 500 })
+  ),
+  getStatus: vi.fn(() => ({ state: 'ready', modelId: 'base', uptime: 0 })),
+  on: vi.fn(),
+  off: vi.fn()
+}
+
+vi.mock('../../../src/main/services/LocalSTTService', () => ({
+  getLocalSTTService: () => mockSTT
+}))
+
+const mockAudio = {
+  start: vi.fn(() => Promise.resolve()),
+  stop: vi.fn(() => Promise.resolve()),
+  on: vi.fn(),
+  off: vi.fn()
+}
+
+vi.mock('../../../src/main/services/AudioCaptureService', () => ({
+  getAudioCaptureService: () => mockAudio
+}))
+
+const mockHotkey = {
+  on: vi.fn(),
+  off: vi.fn()
+}
+
+vi.mock('../../../src/main/services/HotkeyService', () => ({
+  getHotkeyService: () => mockHotkey
+}))
+
+vi.mock('../../../src/main/services/ConfigService', () => ({
+  configGet: vi.fn((key: string) => {
+    const defaults: Record<string, unknown> = {
+      sttModelId: 'base',
+      defaultLLMAction: 'refine',
+      ollamaServerUrl: 'http://localhost:11434',
+      llmModelId: 'qwen3:4b'
+    }
+    return defaults[key]
+  })
+}))
+
+const mockTextInsert = {
+  insertText: vi.fn(() => Promise.resolve({ success: true, method: 'clipboard', textLength: 10, durationMs: 50 }))
+}
+
+vi.mock('../../../src/main/services/TextInsertService', () => ({
+  getTextInsertService: () => mockTextInsert
+}))
+
+const mockLLM = {
+  isAvailable: vi.fn(() => false),
+  processText: vi.fn(() => Promise.resolve('다듬어진 텍스트')),
+  on: vi.fn(),
+  off: vi.fn()
+}
+
+vi.mock('../../../src/main/services/LocalLLMService', () => ({
+  getLocalLLMService: () => mockLLM
+}))
+
+let getVoiceModeService: () => ReturnType<typeof import('../../../src/main/services/VoiceModeService')['getVoiceModeService']>
+
+beforeEach(async () => {
+  vi.resetModules()
+  vi.clearAllMocks()
+  const mod = await import('../../../src/main/services/VoiceModeService')
+  getVoiceModeService = mod.getVoiceModeService
+})
+
+describe('VoiceModeService', () => {
+  describe('상태 머신', () => {
+    it('초기 상태는 IDLE이다', () => {
+      const svc = getVoiceModeService()
+      const state = svc.getState()
+
+      expect(state.recognitionState).toBe(RecognitionState.IDLE)
+      expect(state.audioState).toBe(AudioState.IDLE)
+      expect(state.sessionId).toBeNull()
+    })
+
+    it('startSession 호출 시 PREPARING으로 전이한다', async () => {
+      const svc = getVoiceModeService()
+      const stateChanges: RecognitionState[] = []
+
+      svc.on('recognition-state-changed', (payload: { current: RecognitionState }) => {
+        stateChanges.push(payload.current)
+      })
+
+      await svc.startSession('dictation')
+
+      // PREPARING → CONNECTING → READY 순서
+      expect(stateChanges[0]).toBe(RecognitionState.PREPARING)
+      expect(stateChanges).toContain(RecognitionState.CONNECTING)
+    })
+
+    it('isActive는 세션이 활성일 때 true이다', async () => {
+      const svc = getVoiceModeService()
+      expect(svc.isActive).toBe(false)
+
+      // startSession은 비동기이므로 STT init이 resolve되면 세션 활성
+      const promise = svc.startSession('dictation')
+      expect(svc.isActive).toBe(true) // PREPARING 상태
+
+      await promise
+    })
+  })
+
+  describe('accidentalPress', () => {
+    it('700ms 미만 세션은 자동 취소된다', async () => {
+      const svc = getVoiceModeService()
+      let cancelReason: string | null = null
+
+      svc.on('session-cancelled', (payload: { reason: string }) => {
+        cancelReason = payload.reason
+      })
+
+      // 세션 시작 즉시 종료 (700ms 미만)
+      await svc.startSession('dictation')
+      await svc.stopSession()
+
+      expect(cancelReason).toBe('too-short')
+    })
+  })
+
+  describe('cancelSession', () => {
+    it('user 취소로 세션을 종료한다', async () => {
+      const svc = getVoiceModeService()
+      let cancelReason: string | null = null
+
+      svc.on('session-cancelled', (payload: { reason: string }) => {
+        cancelReason = payload.reason
+      })
+
+      await svc.startSession('dictation')
+      svc.cancelSession()
+
+      expect(cancelReason).toBe('user')
+    })
+  })
+
+  describe('getState', () => {
+    it('현재 상태를 VoiceState 형태로 반환한다', () => {
+      const svc = getVoiceModeService()
+      const state = svc.getState()
+
+      expect(state).toHaveProperty('recognitionState')
+      expect(state).toHaveProperty('audioState')
+      expect(state).toHaveProperty('mode')
+      expect(state).toHaveProperty('sessionId')
+      expect(state).toHaveProperty('recordingStartedAt')
+    })
+  })
+
+  describe('터미널 상태', () => {
+    it('cancelSession 후 _resetToIdle의 200ms 딜레이 후 IDLE로 전이한다', async () => {
+      vi.useFakeTimers()
+      const svc = getVoiceModeService()
+
+      await svc.startSession('dictation')
+      svc.cancelSession()
+
+      // 200ms 딜레이로 IDLE 전이 예약됨
+      vi.advanceTimersByTime(250)
+
+      const state = svc.getState()
+      expect(state.recognitionState).toBe(RecognitionState.IDLE)
+
+      vi.useRealTimers()
+    })
+  })
+})
+
+describe('TIMING 상수', () => {
+  it('핵심 타이밍 값이 Speakly 패턴과 일치한다', () => {
+    expect(TIMING.MIN_AUDIO_DURATION).toBe(700)
+    expect(TIMING.DOUBLE_PRESS_DURATION).toBe(300)
+    expect(TIMING.POST_RECORDING_WAIT).toBe(4000)
+    expect(TIMING.POST_RECORDING_WAIT_BUFFERED).toBe(6000)
+    expect(TIMING.ABSOLUTE_MAX_WAIT).toBe(120000)
+    expect(TIMING.AUDIO_LEVEL_INTERVAL).toBe(100)
+  })
+})