fix(build): add vscode:prepublish script to ensure compilation before vsce package

.agents/references/known-issues.md

@@ -29,6 +29,12 @@
 
 ## 🔴 Active/Recent Issues
 
+### [2026-04-08] [Extension] package.json vscode:prepublish 누락에 따른 Stale Build (VSIX)
+- **증상**: 코드를 정상적으로 수정하고 `vsce package` 명령으로 새 버전을 패키징하여 설치했음에도 불구하고, 여전히 과거 버전의 버그가 나타남 (`out` 폴더 내용물이 갱신되지 않음).
+- **원인**: `vsce package` 실행 시 기본적으로 TS 컴파일을 해주지 않음. `package.json`의 `scripts` 노드에 컴파일러 훅(`vscode:prepublish`)이 없으면 `out/` 폴더에 존재하는 예전 JS 파일을 그대로 압축해버림.
+- **해결**: `package.json`의 `scripts` 내에 `"vscode:prepublish": "npm run compile"`를 명시하여 패키징 전 무조건 빌드되도록 강제함. 필요시 `--no-dependencies` 옵션 등을 쓸 때는 더 주의 필요.
+- **주의**: VSIX 빌드 시 수정 내용이 씹힌 것 같으면 빌드 스크립트 실행 여부를 1순위로 확인하고, `out/` 에 있는 파일의 생성 시간을 점검할 것.
+
 ### [2026-04-08] [Git/Windows] Git Credential Manager UI 팝업 (포커스 스틸)
 - **증상**: 에이전트가 백그라운드에서 `git push origin main` 명령을 실행하자 Windows Git Credential Manager 로그인 창(UI 팝업)이 화면에 나타나 사용자의 작업 포커스를 빼앗고 방해함.
 - **원인**: HTTPS 원격 저장소 주소에 인증 토큰이 없거나 캐시가 만료된 상태에서, Windows 환경의 기본 설정이 대화형 UI 자격 증명 프롬프트를 띄우도록 되어있기 때문.