변경 로그

GitHub Sync 재설계 `IMPROVED`

• 리포지토리 트리와 파일 내용에서 file structure + key format 자동 감지(`flat` vs `nested`)
• 소스 언어에 고정된, 깃발과 언어 이름이 있는 Cloudflare 스타일 추천 카드
• 편집 모달이 File Structure와 Key Format을 노출. 저장은 기존 구조를 보존

네 가지 파일 구조 — 이제 Astro 포함 `NEW`

• Single file `locales/en.json` · Locale folders `locales/en/common.json` · Namespace folders `faq/en.json` *(신규)* · Locale-suffixed `faq.en.json`
• 감지·읽기·대칭 쓰기 경로를 end-to-end로 연결. v2 CDN 매니페스트 포함

더 매끄러운 연결 & 재동기화 `IMPROVED`

• 완료까지 폴링하는 "Sync now" 버튼
• 이미 연결된/고아 리포지토리는 409 대신 reconcile
• "You're all set" 화면. GitHub Sync 플로우는 불필요한 framework/SDK 단계를 건너뜀

번역 워크플로 엔진 — 프로덕션 강화 `IMPROVED`

• 언어별 동시 번역. key-keyed LLM 계약 + dual-limit 청킹 + 재시도
• 배치 워크플로에 GPT-4.1 Mini. 대량 번역은 워크플로 경유
• Cancel이 end-to-end. `translateBatch` 수정(no-op였으나 이제 실행되고 죽은 프로바이더에서 명시적으로 실패)

자체 DeepL 사용 `NEW`

read-after-write 일관성 `IMPROVED`

• 에디터, sync, publish 상태, CMS 활성화가 최신을 읽음
• Billing이 간극을 메움 — Checkout 후 유료 플랜이 즉시 반영
• 보안: 인가 상태는 항상 uncached로 읽음

셀프서비스 계정 삭제 `NEW`

• 이메일 확인 삭제. 전용 확인 페이지 + 종료 이메일(OAuth 포함)
• 확인 대기 상태에 Resend 버튼 + 강화된 삭제 모달. 사용자 FK를 null로

Content CMS — 안전한 게시, 업로드 & Trash `IMPROVED`

• Save-before-publish + dirty-state 게이팅. Trash, 미디어 업로드, 언어별 상태 명확화
• 다중값 관계 필드. 데이터 없을 때 가짜 분석 중단

안정성과 보안 `IMPROVED`

• 스턱-스플래시 콜드로드 수정 + 부트 워치독. error/not-found/empty 상태 재설계
• 파트너 OAuth: 콘텐츠 CRUD, API 키 발급. 중국어 (`zh`) 언어 추가. 프로덕션에서 스택 트레이스 미노출

Mastra 네이티브 AI 에이전트 v3

• Mastra 마이그레이션 — `handleChatStream`이 정규 채팅 라우트. 레거시 AI SDK 라우트 제거.
• 스레드 간 시맨틱 메모리 — Mastra Memory + pgvector를 postgres.js 어댑터(Path B)로 연결. 768차원 임베딩, HNSW 재활성화.
• `useChat`을 통한 HITL — `@ai-sdk/react`의 네이티브 suspend/resume. 커스텀 스냅샷 엔드포인트 불필요.
• 쓰기 도구 Auto-Apply — 쓰기 도구가 즉시 적용. 부분 성공은 「요청 40 / 작성 38」로 정직하게 카운트.
• `webSearch`(Exa) — 프로젝트 인식 리서치, 월간 쿼터.
• 70%+ 컨텍스트 절감 — read/workflow 도구의 Memory 쓰기를 슬림화.

Cloudflare Workers 워크플로 엔진 `NEW`

Helpway 인앱 지원 `NEW`

사이드바 내비게이션 개편

• 상단 내비게이션 바에서 접을 수 있는 사이드바로 이전(ElevenLabs 스타일)
• 스코프 인식 설정 사이드바 + last-context 내비게이션
• 멤버와 청구가 조직 설정 사이드바에 표면화
• 컴팩트 사용량 카드가 사이드바 푸터로
• 콘텐츠 에디터는 단일 헤더 레이아웃 + 브레드크럼

파트너 OAuth 2.0 `STABLE`

• Claude Code 및 Cursor를 위한 OAuth(키 불필요) MCP 온보딩
• RFC 7591 동적 클라이언트 등록 + 중복 제거
• `GET /v1/installations` 그랜트 검색 엔드포인트
• 동의 화면 폴리시 + 자동 리디렉트
• 그랜트 취소는 `dbDirect`를 통해 처리(즉시 반영)

Content CMS 분석 `NEW`

• 항목별 스파크라인(7일/30일 토글)
• Cloudflare 스타일 TimeRangePicker(10가지 프리셋)
• 국가/리퍼러 브레이크다운이 있는 분석 사이드바
• Cloudflare Analytics Engine 위의 KV 캐시 통계 엔드포인트
• `publishEntry`는 본문이 비어 있는 번역의 게시를 거부

텔레메트리, 안정성, 보안

• PostHog Managed Reverse Proxy 마이그레이션 + 소스맵 파이프라인
• `no-cache` index.html + `vite: preloadError` 복구
• TanStack Router #7120 우회(`wrapInSuspense: true`)
• `samlify` >= 2.13.0(XML 인젝션), `dompurify` >= 3.4.0(XSS), `next` >= 16.2.6(8개의 CVE)
• CODEOWNERS + 조직 수준 보안 베이스라인

MCP 에이전트 도구

• 시맨틱 중복 감지 — `createKeys`가 동일 소스 텍스트가 다른 네임스페이스에 존재할 때 경고.
• **팬텀 키 감지** — `listKeys`가 CDN 파일을 손상시키는 레거시 중복 행 플래그 (`p: true`).
• 번역 컨텍스트 v2 — pgvector 유사성 검색을 통한 키별 RAG 검색.
• `setTranslations` — ~60% 더 작은 페이로드로 대량 쓰기.
• `cancelSync` + `getSync` 블로킹 — 대기 중인 게시 취소 및 완료 대기.

OAuth 앱 시스템 `BETA`

CDN 파이프라인

• 해시 기반 diff — 게시당 R2 쓰기 99% 감소.
• 네임스페이스 전달 — 단일 파일 대신 네임스페이스별 번역 제공.
• 소스 작성자 귀속 — 키가 Git 커밋 작성자를 보유.

플랫폼

• Vercel 스타일 청구 UI로 통합 쿼터 적용
• 컨텍스트 인식 AI 드로어 제안
• 콘텐츠 CMS 웹훅 이벤트
• `createKeys`에서 경로 충돌 감지
• CDN 분석이 포함된 관리자 대시보드

번역 편집기

• 일괄 번역 워크플로우: Shift+클릭 범위 선택과 일괄 작업으로 여러 번역을 한 번에 선택, 승인, 거부 또는 번역합니다.

Content CMS

• 관계 필드 및 내장 Users 모델: 콘텐츠 모델이 이제 적절한 편집기 렌더링과 내장 작성자 참조를 갖춰 관계 필드를 지원합니다.
• 콘텐츠 API 키와 통합 가이드: API 키 생성 후 cURL 예제, SDK 설치 명령어, 코드 스니펫이 포함된 빠른 시작 섹션을 제공합니다.
• Cloudflare AI 마이그레이션 및 Content MCP: 모델 기반 인가와 llm.txt 엔드포인트를 갖춰 Cloudflare AI로 더 빠른 AI 번역을 제공합니다.

대시보드

• 빠른 시작의 대화형 AI 채팅: 설정 마법사를 벗어나지 않고 온보딩 플로우에서 직접 AI 어시스턴트를 체험합니다.
• 프로젝트 내비게이션 재설계: 언어를 개요에 통합하고 사이드바 레이아웃으로 설정을 재구성한 더 깔끔한 탭 구조.
• 재설계된 "언어 추가" 플로우: 인기 언어 섹션, 실시간 검색 필터링, 지역 변형 그룹화.

버그 수정 및 개선

• 팀원 권한: 관리자가 더 이상 소유자 역할을 할당하거나 다른 관리자를 제거할 수 없습니다. 대기 중인 초대 수가 이제 올바르게 표시됩니다.
• 사용량 개요: 번역 키 및 AI 사용량 값이 이제 API에서 실제 데이터를 가져옵니다.
• 콘텐츠 편집기 충돌: 항목 상세 페이지의 "Expected drag drop context" 오류가 수정되었습니다.

Content CMS

• 블로그, 변경 로그 및 로드맵 콘텐츠: 완전한 현지화 지원으로 콘텐츠 항목을 만들고 편집합니다.
• 리치 텍스트 편집기: PlateJS로 구동되는 서식, 코드 블록 등을 지원하는 편집 경험.
• 다국어 콘텐츠 번역: 모든 프로젝트 언어에 걸쳐 각 콘텐츠 항목의 번역을 관리합니다.
• 초안/게시 상태 관리: 상태 관리로 콘텐츠가 언제 공개될지 제어합니다.
• Unsplash 통합: 편집기에서 직접 무료 스톡 이미지를 검색하고 추가합니다.
• 자동 저장: 자동 저장으로 작업을 잃지 않습니다.

AI 번역

• 자동 승인 모드: 한 번의 클릭으로 전체 번역 프로세스를 완료합니다.
• 더 빠른 번역 제안: 향상된 AI 모델이 더 높은 품질의 번역을 제공합니다.

대시보드

• 도움말 메뉴: 지원 및 리소스에 빠르게 접근하는 메뉴.
• 시작 가이드: 각 단계별 예상 시간과 메모가 포함된 단계별 설정 마법사.
• 시각적 진행 표시기: 완료된 온보딩 단계를 한눈에 추적합니다.
• 드래그 앤 드롭 언어 순서 지정: 원하는 표시 순서로 언어를 배열합니다.
• 언어 순서 초기화: 영어가 맸 위에 오는 기본 순서로 빠르게 재설정합니다.

AI 에이전트

• 최적화된 AI 응답: 모든 읽기 엔드포인트가 이제 40–50% 더 작은 응답을 반환하여 AI 토큰 비용을 크게 절감합니다.
• 최적화된 도구 출력: `getKeyDetails`가 내장 필드 범례와 함께 더 효율적인 형식(토큰 55% 감소)을 반환합니다.
• 즉각적인 HTTP 스트리밍: AI 채팅이 즉시 HTTP 연결을 열어 초기화 중 인지되는 "중단"을 제거합니다.
• AI 컨텍스트 윈도우: 토큰 카운팅이 이제 누적 합계 대신 마지막 단계 사용량을 사용합니다.
• 자동 승인 UX: 시맨틱 XML 태그를 사용한 더 명확한 자동 승인 프롬프트 플로우.

대시보드

• 메모 활동 유형: 활동 피드에서 추적되는 메모로 번역 키에 주석을 닕니다.
• 청구 주기 토글: 연간 20% 절약 배지가 포함된 월간/연간 요금제.
• 도구 UI 분해: 모놀리식 tool.tsx가 시각적 변화 없이 11개의 집중 파일로 분해되었습니다.

인프라

• R2 이중 버킷 아키텍처: 국기 이미지와 정적 자산이 번역 파일과 분리된 전용 R2 버킷(`s3.better-i18n.com`)으로 마이그레이션되었습니다.
• 게시 쿼리 최적화: 더 빠른 응답 시간을 위한 쿼리 병렬화.
• 사용자 궀속: 동기화 작업이 이제 트리거한 사용자를 추적합니다.

버그 수정 및 개선

• MCP 게시: CDN이 활성화되어 있지만 아직 파일이 업로드되지 않은 경우 실패하는 문제가 수정되었습니다.
• 소프트 삭제 이름 변경: 찾기+이름 변경+삽입에 단일 연결을 사용하는 트랜잭션 문제가 수정되었습니다.
• VList 높이: 소형 번역 목록(<20개)의 높이 불일치 문제가 수정되었습니다.
• 캐시 무효화: 조직 설정 캐시 무효화 키 문제가 수정되었습니다.

MCP 도구

• MCP 게시 도구: 두 가지 새로운 도구 — IDE에서 바로 배포를 미리 보는 `getPendingChanges`와 CDN에 번역을 배포하는 `publish`.
• 완전한 MCP 워크플로우: AI 어시스턴트가 이제 전체 사이클을 따를 수 있습니다: 읽기 → 번역 → 검증 → 게시 → 확인.
• 대기 중인 게시 힌트: 쓰기 작업이 이제 변경 사항이 준비되면 게시를 호출하도록 AI에게 상기시키는 힌트를 반환합니다.
• MCP 라우터 문서: 카테고리와 권장 워크플로우 가이드가 포함된 포괄적인 도구 문서.

CDN 및 게시

• 기본 CDN 형식: i18n 라이브러리 호환성 향상을 위해 기본값을 JSON_FLAT에서 JSON_NESTED로 변경했습니다.
• CDN 폴백 기본 활성화: 새 프로젝트가 자동으로 폴백 언어 지원을 활성화합니다.

대시보드

• 더 안전한 키 재생성: 단일 데이터베이스 트랜잭션으로 소프트 삭제 이름 변경을 수정하여 충돌을 방지합니다.
• 더 나은 채팅 압욹: `/compact` 명령이 이제 사용자 메시지와 실제 요약 내용을 표시합니다.
• 언어 정렬: 언어가 이제 상태별로 정렬됩니다: 활성 → 초안 → 보관됨.

버그 수정 및 개선

• 슬래시 명령 자동 제출: 이중 제출 문제가 수정되었습니다.
• 요약 정리: 서버 측에서 더 이상 사용되지 않는 요약 도구가 제거되었습니다.

AI 및 MCP

• AI를 위한 네임스페이스 컨텍스트: AI 모델이 이제 키를 생성하거나 업데이트할 때 풍부한 컨텍스트(설명, 팀, 도메인, AI 프롬프트, 태그)를 첨부할 수 있습니다.
• 더 스마트한 키 언급: AI 채팅엔서 언급된 키가 이제 정확한 AI 타겟팅을 위해 네임스페이스 컨텍스트를 포함합니다.
• 더 빠른 Gemini 스트리밍: Gemini 모델에 최적화된 시스템 프롬프트로 스트리밍 속도가 크게 향상되었습니다.

SDK 및 플랫폼

• 현지화 폴백: 새 언어를 추가할 때 누락된 키가 자동으로 폴백 언어에서 상속됩니다.
• 오픈 소스 출시: 패키지, MCP 서버, 랜딩 페이지가 이제 github.com/better-i18n/oss에 공개되었습니다.
• 관계형 네임스페이스: 번역 키가 이제 더 나은 구성을 위해 네임스페이스와 적절한 관계 연결을 갖습니다.

대시보드

• 재설계된 프로젝트 설정: 더 나은 사용성을 위해 완전히 개편된 프로젝트 설정 인터페이스.
• 향상된 필터 UI: 번역 대시보드 전반의 필터링 경험이 개선되었습니다.
• CDN 재게시 지원: CDN 파일을 삭제하면 이제 게시 상태가 초기화되어 깨끗하게 재게시할 수 있습니다.

AI 에이전트

• 더 부드러운 AI 응답: AI SDK를 v6.0.39로 업그레이드하여 smoothStream으로 유연하고 자연스러운 응답 스트리밍을 구현했습니다.
• 스마트 컨텍스트 캐싱: 프로젝트 컨텍스트 쿼리의 30초 캐시로 데이터베이스 부하를 줄이고 AI 응답 속도를 높입니다.
• 더 스마트한 AI 사고: 더 정확한 번역 결정을 위한 사고 구성이 업그레이드되었습니다.

MCP 및 개발자 도구

• 더 나은 MCP 도구 스키마: 더 직관적인 IDE 통합을 위해 MCP 도구 입력 형식이 재설계되었습니다.
• 즉각적인 MCP 번역: MCP를 통해 생성된 키가 이제 자동으로 승인됩니다.
• 향상된 키 언급: AI 채팅의 키 언급에 더 나은 컨텍스트 인식을 위한 네임스페이스 필드가 추가되었습니다.

대시보드

• 저장된 뷰 설명: 저장된 번역 뷰에 설명과 개인 정보 설정을 추가합니다.
• 더 깔끔한 채팅 UI: 시각적 혼란을 줄인 간소화된 복사 버튼 디자인.

버그 수정 및 개선

• 메시지 파싱: 디버그 console.log를 제거하는 메시지 파싱 문제가 수정되었습니다.
• 게시 안정성: 게시 배치 프로세서 안정성이 향상되었습니다.
• 데이터 무결성: 더 나은 데이터 무결성을 위한 소프트 삭제 헬퍼 함수가 강화되었습니다.

AI 에이전트

• MCP 키 삭제 도구: MCP 서버를 사용하여 IDE에서 직접 번역 키를 소프트 삭제합니다.
• AI 에이전트 성능: 더 빠른 응답 시간과 더 나은 컨텍스트 처리.
• 채팅 요약: 긴 세션의 대화 요약이 개선되었습니다.
• Gemini 통합: 더 나은 AI 응답을 위해 새로운 thinkingBudget API로 마이그레이션되었습니다.

대시보드

• 개발자 도구 모달: 채팅 세션 뷰어와 네트워크 인스펝터가 포함된 새로운 현대적인 DevTools.
• 관리자 사용자 가장: 팀 관리자가 이제 디버깅을 위해 사용자를 가장할 수 있습니다.

버그 수정 및 개선

• RLS 보안: 적절한 트랜잭션 처리로 RLS 우회 문제가 수정되었습니다.
• 소프트 삭제 정덕: 소프트 삭제 RLS 정덕이 올바르게 작동하지 않는 문제가 해결되었습니다.
• API 키 복호화: API 키 복호화 문제가 수정되었습니다.