d3ro-voice/apps/desktop/tests/main/services/llm-prompts.test.ts

// tests/main/services/llm-prompts.test.ts
// 플레이스홀더 치환 + 지시문 인자 배치 회귀 테스트.
// 지시문이 시스템 프롬프트가 아닌 처리 대상 텍스트 자리로 들어가 LLM이
// 지시문 자체를 다듬어 반환하던 버그를 막는다.

import { describe, it, expect, beforeEach, vi } from 'vitest'

const mockLogger = vi.hoisted(() => ({
  info: vi.fn(),
  warn: vi.fn(),
  error: vi.fn(),
  debug: vi.fn(),
}))

vi.mock('../../../src/main/services/LoggerService', () => ({
  getLogger: () => mockLogger,
}))

import {
  renderInstructionPrompt,
  buildInstructionInvocation,
  resolveSystemPrompt,
  buildSuggestionPrompt,
  DEFAULT_TARGET_LANGUAGE,
  BASE_SYSTEM_PROMPTS,
  SUGGESTION_NO_THINK_PREFIX,
} from '../../../src/main/services/llm-prompts'

beforeEach(() => {
  vi.clearAllMocks()
})

describe('renderInstructionPrompt', () => {
  it('{{text}}를 사용자 텍스트로 치환한다', () => {
    const result = renderInstructionPrompt('요약해줘:\n{{text}}', { text: '안녕하세요' })
    expect(result).toBe('요약해줘:\n안녕하세요')
  })

  it('{{userPrompt}}를 사용자 텍스트로 치환한다 (자유 프롬프트 프리셋)', () => {
    const result = renderInstructionPrompt('{{userPrompt}}', { text: '오늘 날씨 알려줘' })
    expect(result).toBe('오늘 날씨 알려줘')
  })

  it('{{targetLanguage}}를 주어진 대상 언어로 치환한다', () => {
    const result = renderInstructionPrompt('{{targetLanguage}}로 번역해줘', {
      text: '안녕',
      targetLanguage: '일본어',
    })
    expect(result).toBe('일본어로 번역해줘')
  })

  it('대상 언어가 없으면 기본값으로 치환한다', () => {
    const result = renderInstructionPrompt('{{targetLanguage}}로 번역해줘', { text: '안녕' })
    expect(result).toBe(`${DEFAULT_TARGET_LANGUAGE}로 번역해줘`)
    expect(result).not.toContain('{{')
  })

  it('같은 플레이스홀더가 여러 번 나와도 모두 치환한다', () => {
    const result = renderInstructionPrompt('{{text}} / {{text}}', { text: 'A' })
    expect(result).toBe('A / A')
  })

  it('치환되지 않고 남은 플레이스홀더는 경고로 남기되 동작은 계속한다', () => {
    const result = renderInstructionPrompt('{{text}}를 {{unknownVar}}로 처리해줘', { text: 'A' })

    expect(result).toBe('A를 {{unknownVar}}로 처리해줘')
    expect(mockLogger.warn).toHaveBeenCalledTimes(1)
    expect(mockLogger.warn.mock.calls[0][0]).toContain('unknownVar')
  })

  it('플레이스홀더가 모두 치환되면 경고하지 않는다', () => {
    renderInstructionPrompt('{{text}}', { text: 'A' })
    expect(mockLogger.warn).not.toHaveBeenCalled()
  })
})

describe('buildInstructionInvocation', () => {
  it('{{text}}가 없는 지시문은 시스템 프롬프트로, 사용자 텍스트는 처리 대상으로 보낸다', () => {
    // builtin-summarize 와 같은 모양 — 플레이스홀더 없음
    const invocation = buildInstructionInvocation(
      '다음 텍스트의 핵심 내용을 3줄 이내로 요약해주세요.',
      '오늘 회의에서 배포 일정을 정했습니다',
    )

    expect(invocation.text).toBe('오늘 회의에서 배포 일정을 정했습니다')
    expect(invocation.systemPrompt).toBe('다음 텍스트의 핵심 내용을 3줄 이내로 요약해주세요.')
  })

  it('builtin-translate 지시문은 대상 언어를 치환해 시스템 프롬프트로 보낸다', () => {
    const invocation = buildInstructionInvocation(
      '다음 텍스트를 {{targetLanguage}}로 번역해주세요.\n자연스럽고 정확한 번역만 출력하세요.',
      '안녕하세요',
    )

    expect(invocation.text).toBe('안녕하세요')
    expect(invocation.systemPrompt).toBe(
      `다음 텍스트를 ${DEFAULT_TARGET_LANGUAGE}로 번역해주세요.\n자연스럽고 정확한 번역만 출력하세요.`,
    )
    expect(invocation.systemPrompt).not.toContain('{{')
  })

  it('builtin-free-prompt는 사용자 텍스트를 시스템 프롬프트로 보낸다', () => {
    const invocation = buildInstructionInvocation('{{userPrompt}}', '파이썬으로 피보나치 짜줘')

    expect(invocation.text).toBe('파이썬으로 피보나치 짜줘')
    expect(invocation.systemPrompt).toBe('파이썬으로 피보나치 짜줘')
  })

  it('{{text}}를 쓰는 지시문은 하위 호환을 위해 치환 결과를 처리 대상 텍스트로 보낸다', () => {
    const invocation = buildInstructionInvocation('아래를 불릿으로 정리해줘:\n{{text}}', '가 나 다')

    expect(invocation.text).toBe('아래를 불릿으로 정리해줘:\n가 나 다')
    expect(invocation.systemPrompt).toBeUndefined()
  })

  it('명시적 대상 언어를 그대로 사용한다', () => {
    const invocation = buildInstructionInvocation(
      '{{targetLanguage}}로 번역해줘',
      '안녕',
      '프랑스어',
    )

    expect(invocation.systemPrompt).toBe('프랑스어로 번역해줘')
  })
})

describe('resolveSystemPrompt', () => {
  it("action 'custom'에 프롬프트가 있으면 그대로 시스템 프롬프트로 쓴다", () => {
    expect(resolveSystemPrompt('custom', undefined, '전문 용어를 풀어써라')).toBe(
      '전문 용어를 풀어써라',
    )
    expect(mockLogger.warn).not.toHaveBeenCalled()
  })

  it("action 'custom'인데 프롬프트가 비어 있으면 조용히 떨어지지 않고 경고한다", () => {
    const result = resolveSystemPrompt('custom', undefined, undefined)

    expect(mockLogger.warn).toHaveBeenCalledTimes(1)
    expect(mockLogger.warn.mock.calls[0][0]).toContain('custom')
    expect(result).toBe(resolveSystemPrompt('refine'))
  })

  it("공백뿐인 custom 프롬프트도 비어 있는 것으로 보고 경고한다", () => {
    resolveSystemPrompt('custom', undefined, '   ')
    expect(mockLogger.warn).toHaveBeenCalledTimes(1)
  })

  it('translate 액션은 대상 언어를 치환한다', () => {
    expect(resolveSystemPrompt('translate', '독일어')).toContain('독일어로 번역')
    expect(resolveSystemPrompt('translate')).toContain(`${DEFAULT_TARGET_LANGUAGE}로 번역`)
  })

  // 수정 대상이 아닌 일반 액션들이 각자의 프롬프트로 해석되는지 잠근다.
  // 이들이 refine으로 조용히 폴백하면 커스텀 경로와 같은 사고가 난다.
  it.each(['refine', 'summarize', 'grammar', 'expand'] as const)(
    "'%s' 액션은 자기 자신의 시스템 프롬프트로 해석된다",
    (action) => {
      const resolved = resolveSystemPrompt(action)

      expect(resolved).toBe(BASE_SYSTEM_PROMPTS[action])
      expect(resolved).not.toContain('{{')
      expect(mockLogger.warn).not.toHaveBeenCalled()
    },
  )

  it('refine 이외의 일반 액션이 refine 프롬프트로 폴백하지 않는다', () => {
    for (const action of ['summarize', 'grammar', 'expand'] as const) {
      expect(resolveSystemPrompt(action)).not.toBe(BASE_SYSTEM_PROMPTS.refine)
    }
  })
})

describe('buildSuggestionPrompt', () => {
  it('지시문은 시스템 프롬프트에만 있고 사용자 텍스트에는 들어가지 않는다', () => {
    const { systemPrompt, text } = buildSuggestionPrompt({
      prefix: '오늘 회의에서 논의한 내용을 정리해서',
      appName: 'chrome.exe',
      windowTitle: '회의록 - Chrome',
      phraseHints: ['지난번에는 이렇게 정리했습니다'],
      candidates: 3,
      maxChars: 120
    })

    // 지시문이 사용자 텍스트 자리로 새면 모델이 지시문 자체를 다듬어 돌려준다
    // (commit 9c2b4d4 회와 같은 부류).
    expect(systemPrompt).toContain('다음 문장')
    expect(text).not.toContain('규칙:')
    expect(text).toContain('오늘 회의에서 논의한 내용을 정리해서')
    expect(text).toContain('지난번에는 이렇게 정리했습니다')
    expect(text).toContain('chrome.exe')
  })

  it('후보 수와 길이 상한을 프롬프트에 반영한다', () => {
    const { systemPrompt, text } = buildSuggestionPrompt({ prefix: 'abc', candidates: 2, maxChars: 60 })

    expect(systemPrompt).toContain('60')
    expect(text).toContain('2')
  })

  it('추론 모델용 no_think prefix 를 붙인다', () => {
    const { systemPrompt } = buildSuggestionPrompt({ prefix: 'abc' })
    expect(systemPrompt.startsWith(SUGGESTION_NO_THINK_PREFIX)).toBe(true)
  })

  it('후보 수/길이는 안전 범위로 클램프한다', () => {
    const { systemPrompt, text } = buildSuggestionPrompt({
      prefix: 'abc',
      candidates: 99,
      maxChars: 99999
    })

    expect(systemPrompt).toContain('400')
    expect(text).toContain('5')
  })
})