# Autocomplete 드롭다운 버그 수정 회의 결과

> **일시**: 2026-02-23 01:18
> **참석자**: PM, Frontend, Backend, QA, UX
> **안건/주제**: Reflect 에디터 `[[` 입력 시 추천 창(Autocomplete) 증발 문제 파악 및 복구

---

## 1. 개요 및 근본 원인 분석 (Root Cause Analysis)
사용자가 `[[`를 입력했을 때 연관된 문서를 추천해주는 Autocomplete 드롭다운 기능이 사라진 현상의 원인을 분석했습니다.

### 발견된 버그 (TipTap Option Overwrite)
- **현상**: 에디터에서 `[[` 타이핑 시 아무런 팝업 창이 뜨지 않음.
- **원인**: `ReflectEditor.tsx`에서 `WikiLinkExtension`을 불러올 때 `.configure({ suggestion: suggestionOptions(searchDocuments) })`를 호출하여 옵션을 주입할 때, TipTap의 내부 구조상 `suggestion` 객체 전체가 **얕은 복사(Shallow overwrite)** 되어 교체되었습니다. 
  이로 인해 기존 `WikiLinkExtension.ts`의 `addOptions()` 내부에 기본 탑재되어 있던 `char: '[['` (트리거 문자), `command` (생성 로직), `allow` 권한체크 등의 필수 프로퍼티들이 모두 덮어씌워져 유실(Lost)되었습니다.

---

## 2. 해결 방안 및 조치 내역 (Actions Taken)

1. **`nextapp/src/lib/tiptap/WikiLinkExtension.ts` 업데이트**
   - `suggestionOptions` 함수 내부에서 반환하는 객체(`return {}`)에, 유실되던 필수 프로퍼티(`char: '[['`, `allowSpaces`, `command`, `allow`)들을 명시적으로 재선언하여 렌더링 함수와 함께 반환하도록 수정했습니다.
   - 이렇게 함으로써 `.configure()`로 덮어씌우게 되더라도 리턴 객체 안에 필수 요소가 포함되어 있으므로 설정이 보존됩니다.

---

## 3. 검증 (Verification)

1. **빌드 성공 여부**: `npm run build` 결과 추가된 속성들로 인해 Typescript 충돌 등 에러가 발생하지 않음을 검증 (Exit code: 0).
2. `WikiLinkExtension` 내 Node 속성과 렌더링 명령어(`command`) 의 호환성 확인.