@su-record/vibe 2.0.0 → 2.0.2

package/dist/tools/prompt/enhancePromptGemini.js

@@ -99,134 +99,134 @@ export async function enhancePromptGemini(args) {
 // Helper methods
 function addFewShotExamples(prompt, agent_role) {
     const examples = {
-        'Specification Agent': `
-**예시 1: 푸시 알림 설정**
-입력: "댓글, 좋아요, 팔로우 알림을 켜고 끌 수 있게 해주세요"
-출력:
-- 알림 유형: 6개 (댓글, 좋아요, 팔로우, 공지, 이벤트, 마케팅)
-- 설정 방식: ON/OFF 토글
-- 디자인 참고: iOS Settings > Notifications
-- 기술 스택: FCM (기존 사용 중)
-
-**예시 2: 사용자 프로필 편집**
-입력: "프로필 사진이랑 자기소개를 바꿀 수 있게 해주세요"
-출력:
-- 편집 항목: 프로필 사진, 자기소개, 표시 이름
-- 검증: 이미지 크기 < 5MB, 자기소개 < 500자
-- UI 패턴: 인라인 편집 (모달 아님)
+        'Specification Agent': `
+**예시 1: 푸시 알림 설정**
+입력: "댓글, 좋아요, 팔로우 알림을 켜고 끌 수 있게 해주세요"
+출력:
+- 알림 유형: 6개 (댓글, 좋아요, 팔로우, 공지, 이벤트, 마케팅)
+- 설정 방식: ON/OFF 토글
+- 디자인 참고: iOS Settings > Notifications
+- 기술 스택: FCM (기존 사용 중)
+
+**예시 2: 사용자 프로필 편집**
+입력: "프로필 사진이랑 자기소개를 바꿀 수 있게 해주세요"
+출력:
+- 편집 항목: 프로필 사진, 자기소개, 표시 이름
+- 검증: 이미지 크기 < 5MB, 자기소개 < 500자
+- UI 패턴: 인라인 편집 (모달 아님)
 - 저장 방식: 자동 저장 (debounce 500ms)`,
-        'Planning Agent': `
-**예시 1: API 엔드포인트 추가**
-입력: "사용자 팔로우/언팔로우 기능"
-출력:
-- Phase 1: Backend (8시간)
-  - DB 스키마 (follows 테이블)
-  - API 엔드포인트 (POST /follows, DELETE /follows/:id)
-  - 비즈니스 로직 (중복 방지, 자기 팔로우 금지)
-- Phase 2: Frontend (6시간)
-  - 팔로우 버튼 컴포넌트
-  - 팔로워/팔로잉 목록
-- 비용 영향: +0원 (기존 인프라 활용)
-
-**예시 2: 실시간 알림**
-입력: "댓글 달리면 실시간으로 알림"
-출력:
-- Phase 1: WebSocket 서버 구축 (12시간)
-- Phase 2: 클라이언트 구독 로직 (8시간)
-- Phase 3: 알림 UI (6시간)
+        'Planning Agent': `
+**예시 1: API 엔드포인트 추가**
+입력: "사용자 팔로우/언팔로우 기능"
+출력:
+- Phase 1: Backend (8시간)
+  - DB 스키마 (follows 테이블)
+  - API 엔드포인트 (POST /follows, DELETE /follows/:id)
+  - 비즈니스 로직 (중복 방지, 자기 팔로우 금지)
+- Phase 2: Frontend (6시간)
+  - 팔로우 버튼 컴포넌트
+  - 팔로워/팔로잉 목록
+- 비용 영향: +0원 (기존 인프라 활용)
+
+**예시 2: 실시간 알림**
+입력: "댓글 달리면 실시간으로 알림"
+출력:
+- Phase 1: WebSocket 서버 구축 (12시간)
+- Phase 2: 클라이언트 구독 로직 (8시간)
+- Phase 3: 알림 UI (6시간)
 - 비용 영향: +$20/월 (Redis Pub/Sub)`
     };
-    return examples[agent_role] || `
-**Few-Shot 예시를 작업 유형에 맞게 추가**:
-- 예시 1: [구체적인 입력] → [명확한 출력]
-- 예시 2: [다른 형태의 입력] → [일관된 형식의 출력]
-- 예시 3: [엣지 케이스] → [처리 방법]
-
-**지침**:
-- 2-3개 예시 (과적합 방지)
-- 다양한 시나리오 포함
+    return examples[agent_role] || `
+**Few-Shot 예시를 작업 유형에 맞게 추가**:
+- 예시 1: [구체적인 입력] → [명확한 출력]
+- 예시 2: [다른 형태의 입력] → [일관된 형식의 출력]
+- 예시 3: [엣지 케이스] → [처리 방법]
+
+**지침**:
+- 2-3개 예시 (과적합 방지)
+- 다양한 시나리오 포함
 - 일관된 출력 형식 유지`;
 }
 function specifyOutputFormat(prompt, agent_role) {
     const formats = {
-        'Specification Agent': `
-**출력 형식 (마크다운 + YAML frontmatter)**:
-
-\`\`\`markdown
----
-title: [기능 이름]
-priority: [HIGH/MEDIUM/LOW]
-created: [날짜]
----
-
-# SPEC: [기능 이름]
-
-## REQ-001: [요구사항 제목]
-**WHEN** [조건]
-**THEN** [결과]
-
-### Acceptance Criteria
-- [ ] [기준 1]
-- [ ] [기준 2]
-\`\`\`
-
+        'Specification Agent': `
+**출력 형식 (마크다운 + YAML frontmatter)**:
+
+\`\`\`markdown
+---
+title: [기능 이름]
+priority: [HIGH/MEDIUM/LOW]
+created: [날짜]
+---
+
+# SPEC: [기능 이름]
+
+## REQ-001: [요구사항 제목]
+**WHEN** [조건]
+**THEN** [결과]
+
+### Acceptance Criteria
+- [ ] [기준 1]
+- [ ] [기준 2]
+\`\`\`
+
 **응답 접두사**: "# SPEC: "로 시작하여 모델이 올바른 형식으로 완성하도록 유도`,
-        'Planning Agent': `
-**출력 형식 (구조화된 마크다운)**:
-
-\`\`\`markdown
-# PLAN: [기능 이름]
-
-## Architecture
-- Backend: [기술 스택]
-- Frontend: [기술 스택]
-- Database: [스키마 변경사항]
-
-## Timeline
-| Phase | Tasks | Duration |
-|-------|-------|----------|
-| 1     | ...   | 8h       |
-
-## Cost Analysis
-- Infrastructure: +$X/월
-- Third-party: +$Y/월
-- Total: +$Z/월
-\`\`\`
-
+        'Planning Agent': `
+**출력 형식 (구조화된 마크다운)**:
+
+\`\`\`markdown
+# PLAN: [기능 이름]
+
+## Architecture
+- Backend: [기술 스택]
+- Frontend: [기술 스택]
+- Database: [스키마 변경사항]
+
+## Timeline
+| Phase | Tasks | Duration |
+|-------|-------|----------|
+| 1     | ...   | 8h       |
+
+## Cost Analysis
+- Infrastructure: +$X/월
+- Third-party: +$Y/월
+- Total: +$Z/월
+\`\`\`
+
 **응답 접두사**: "# PLAN: "로 시작`
     };
-    return formats[agent_role] || `
-**출력 형식 명시**:
-- 마크다운 헤더로 섹션 구분 (##, ###)
-- 테이블, 불릿 포인트, 체크박스 활용
-- XML 태그로 의미 구성요소 레이블링 (선택)
-  예: <analysis>...</analysis>, <recommendation>...</recommendation>
-- 응답 접두사로 완성 유도
+    return formats[agent_role] || `
+**출력 형식 명시**:
+- 마크다운 헤더로 섹션 구분 (##, ###)
+- 테이블, 불릿 포인트, 체크박스 활용
+- XML 태그로 의미 구성요소 레이블링 (선택)
+  예: <analysis>...</analysis>, <recommendation>...</recommendation>
+- 응답 접두사로 완성 유도
   예: "분석 결과: "로 시작하면 모델이 분석 내용으로 완성`;
 }
 function optimizeContextPlacement(prompt) {
-    return `
-**컨텍스트 배치 최적화 (Gemini 3 권장)**:
-
-1. **긴 컨텍스트를 앞에 배치**:
-\`\`\`
-[기술 스택 정보 (CLAUDE.md 내용)]
-[기존 코드베이스 구조]
-[관련 SPEC/PLAN 문서]
-
---- 이후 구체적 요청 ---
-
-[사용자의 구체적 질문이나 작업]
-\`\`\`
-
-2. **컨텍스트 구조화**:
-- 카테고리별로 그룹화 (기술 스택, 아키텍처, 비즈니스 로직)
-- 중요한 제약 조건은 반복해서 강조
-- 참조 가능하도록 명확한 레이블링
-
-3. **명시적 지시사항 배치**:
-- 컨텍스트 다음에 구체적 작업 지시
-- 단계별 지침 (1, 2, 3...)
+    return `
+**컨텍스트 배치 최적화 (Gemini 3 권장)**:
+
+1. **긴 컨텍스트를 앞에 배치**:
+\`\`\`
+[기술 스택 정보 (CLAUDE.md 내용)]
+[기존 코드베이스 구조]
+[관련 SPEC/PLAN 문서]
+
+--- 이후 구체적 요청 ---
+
+[사용자의 구체적 질문이나 작업]
+\`\`\`
+
+2. **컨텍스트 구조화**:
+- 카테고리별로 그룹화 (기술 스택, 아키텍처, 비즈니스 로직)
+- 중요한 제약 조건은 반복해서 강조
+- 참조 가능하도록 명확한 레이블링
+
+3. **명시적 지시사항 배치**:
+- 컨텍스트 다음에 구체적 작업 지시
+- 단계별 지침 (1, 2, 3...)
 - 출력 형식 예시`;
 }
 function decomposePrompt(prompt, agent_role) {
@@ -234,32 +234,32 @@ function decomposePrompt(prompt, agent_role) {
     if (!isComplex) {
         return '**프롬프트 분해 불필요**: 단순한 작업이므로 단일 프롬프트로 충분합니다.';
     }
-    return `
-**프롬프트 분해 (순차적 체인)**:
-
-**Step 1: 정보 수집**
-\`\`\`
-프롬프트: "${prompt.slice(0, 100)}..."에 대한 필수 정보를 식별하세요.
-출력: 필요한 기술 스택, 제약 조건, 선행 작업 목록
-\`\`\`
-
-**Step 2: 분석 및 계획**
-\`\`\`
-프롬프트: Step 1의 정보를 바탕으로 구현 계획을 작성하세요.
-입력: [Step 1의 출력]
-출력: Phase별 작업, 타임라인, 리스크
-\`\`\`
-
-**Step 3: 세부 작업 생성**
-\`\`\`
-프롬프트: Step 2의 계획을 실행 가능한 작업으로 분해하세요.
-입력: [Step 2의 출력]
-출력: Task 목록 (의존성 포함)
-\`\`\`
-
-**장점**:
-- 각 단계의 출력 품질 향상
-- 중간 검증 가능
+    return `
+**프롬프트 분해 (순차적 체인)**:
+
+**Step 1: 정보 수집**
+\`\`\`
+프롬프트: "${prompt.slice(0, 100)}..."에 대한 필수 정보를 식별하세요.
+출력: 필요한 기술 스택, 제약 조건, 선행 작업 목록
+\`\`\`
+
+**Step 2: 분석 및 계획**
+\`\`\`
+프롬프트: Step 1의 정보를 바탕으로 구현 계획을 작성하세요.
+입력: [Step 1의 출력]
+출력: Phase별 작업, 타임라인, 리스크
+\`\`\`
+
+**Step 3: 세부 작업 생성**
+\`\`\`
+프롬프트: Step 2의 계획을 실행 가능한 작업으로 분해하세요.
+입력: [Step 2의 출력]
+출력: Task 목록 (의존성 포함)
+\`\`\`
+
+**장점**:
+- 각 단계의 출력 품질 향상
+- 중간 검증 가능
 - 에러 발생 시 특정 단계만 재실행`;
 }
 function suggestParameters(prompt, agent_role) {
@@ -277,24 +277,24 @@ function suggestParameters(prompt, agent_role) {
         topP = 0.8;
         topK = 20;
     }
-    return `
-**권장 매개변수** (작업 특성 기반):
-
-- **Temperature**: ${temperature}
-  ${temperature > 0.7 ? '창의적 작업에 적합 (다양한 옵션 탐색)' : '결정적 작업에 적합 (일관된 출력)'}
-
-- **Top-P**: ${topP}
-  누적 확률 ${topP * 100}%까지의 토큰만 선택
-
-- **Top-K**: ${topK}
-  상위 ${topK}개 토큰만 고려
-
-- **Max Output Tokens**: ${agent_role === 'Specification Agent' ? '4000 (상세 문서)' : '2000 (일반)'}
-
-- **Stop Sequences**: ["---END---", "\`\`\`"] (선택)
-
-**주의**:
-- Gemini 3는 temperature 기본값 1.0 유지 권장
+    return `
+**권장 매개변수** (작업 특성 기반):
+
+- **Temperature**: ${temperature}
+  ${temperature > 0.7 ? '창의적 작업에 적합 (다양한 옵션 탐색)' : '결정적 작업에 적합 (일관된 출력)'}
+
+- **Top-P**: ${topP}
+  누적 확률 ${topP * 100}%까지의 토큰만 선택
+
+- **Top-K**: ${topK}
+  상위 ${topK}개 토큰만 고려
+
+- **Max Output Tokens**: ${agent_role === 'Specification Agent' ? '4000 (상세 문서)' : '2000 (일반)'}
+
+- **Stop Sequences**: ["---END---", "\`\`\`"] (선택)
+
+**주의**:
+- Gemini 3는 temperature 기본값 1.0 유지 권장
 - 예상치 못한 동작 방지를 위해 기본값에서 크게 벗어나지 않기`;
 }
 function combineEnhancements(prompt, enhancements) {
@@ -308,7 +308,7 @@ function combineEnhancements(prompt, enhancements) {
     return enhanced;
 }
 function generateSummary(enhancements) {
-    return `${enhancements.length}개의 Gemini 프롬프팅 전략을 적용하여 프롬프트 품질을 향상시켰습니다:
+    return `${enhancements.length}개의 Gemini 프롬프팅 전략을 적용하여 프롬프트 품질을 향상시켰습니다:
 ${enhancements.map(e => `- ${e.strategy}: ${e.improvement}`).join('\n')}`;
 }
 function formatOutput(result) {

package/dist/tools/reasoning/applyReasoningFramework.js

@@ -154,10 +154,10 @@ export async function applyReasoningFramework(args) {
 }
 // Helper methods
 function analyzeConstraints(problem, context) {
-    return `**제약 조건 분석**:
-- 정책/규칙: ${context ? '프로젝트 컨텍스트 확인 필요' : 'CLAUDE.md, constitution.md 확인 필요'}
-- 작업 순서: 선행 작업 식별 필요 (DB → Backend → Frontend 패턴 고려)
-- 전제 조건: ${problem}을(를) 위한 필수 정보/도구 확인
+    return `**제약 조건 분석**:
+- 정책/규칙: ${context ? '프로젝트 컨텍스트 확인 필요' : 'CLAUDE.md, constitution.md 확인 필요'}
+- 작업 순서: 선행 작업 식별 필요 (DB → Backend → Frontend 패턴 고려)
+- 전제 조건: ${problem}을(를) 위한 필수 정보/도구 확인
 - 사용자 제약: 명시적 요청사항 우선 적용`;
 }
 function assessRisks(problem, context) {
@@ -166,82 +166,82 @@ function assessRisks(problem, context) {
         problem.toLowerCase().includes('확인') ||
         problem.toLowerCase().includes('find') ||
         problem.toLowerCase().includes('analyze');
-    return `**위험 평가**:
-- 작업 유형: ${isExploration ? '탐색 작업 (낮은 위험)' : '구현 작업 (높은 위험)'}
-- 롤백 가능성: ${isExploration ? '높음' : '확인 필요'}
-- 호환성 위험: 기존 코드와의 충돌 가능성 검토
-- 보안 위험: SQL Injection, XSS, 민감 정보 노출 검토
+    return `**위험 평가**:
+- 작업 유형: ${isExploration ? '탐색 작업 (낮은 위험)' : '구현 작업 (높은 위험)'}
+- 롤백 가능성: ${isExploration ? '높음' : '확인 필요'}
+- 호환성 위험: 기존 코드와의 충돌 가능성 검토
+- 보안 위험: SQL Injection, XSS, 민감 정보 노출 검토
 - 성능 위험: N+1 쿼리, 메모리 누수, 불필요한 리렌더 검토`;
 }
 function generateHypotheses(problem, context) {
-    return `**가설 생성**:
-1. **가설 1** (가능성: 높음)
-   - 근거: ${problem}의 가장 직접적인 원인
-   - 검증: [도구/파일]을 통해 확인
-2. **가설 2** (가능성: 중간)
-   - 근거: 간접적 요인 또는 환경 차이
-   - 검증: 추가 정보 수집 필요
-3. **가설 3** (가능성: 낮음)
-   - 근거: 엣지 케이스 또는 드문 상황
-   - 검증: 다른 가설 반증 시 검토
-
+    return `**가설 생성**:
+1. **가설 1** (가능성: 높음)
+   - 근거: ${problem}의 가장 직접적인 원인
+   - 검증: [도구/파일]을 통해 확인
+2. **가설 2** (가능성: 중간)
+   - 근거: 간접적 요인 또는 환경 차이
+   - 검증: 추가 정보 수집 필요
+3. **가설 3** (가능성: 낮음)
+   - 근거: 엣지 케이스 또는 드문 상황
+   - 검증: 다른 가설 반증 시 검토
+
 **우선순위**: 가능성 높은 순으로 검증하되, 낮은 가능성도 완전히 배제하지 않음`;
 }
 function evaluateAdaptability(problem, context) {
-    return `**적응성 평가**:
-- 관찰 결과 반영: 새로운 정보에 따라 계획 수정 필요 여부 확인
-- 가설 업데이트: 반증된 가설 폐기, 새 가설 생성
-- 백트래킹: 막다른 길 도달 시 이전 단계로 돌아가 다른 경로 탐색
+    return `**적응성 평가**:
+- 관찰 결과 반영: 새로운 정보에 따라 계획 수정 필요 여부 확인
+- 가설 업데이트: 반증된 가설 폐기, 새 가설 생성
+- 백트래킹: 막다른 길 도달 시 이전 단계로 돌아가 다른 경로 탐색
 - 계획 재평가: 전체 접근법이 유효한지 주기적으로 검토`;
 }
 function identifyInformationSources(problem, context) {
-    return `**정보 소스**:
-1. **도구**:
-   - MCP 도구 (hi-ai 38개 도구)
-   - 파일 시스템 (Read, Write, Edit, Glob, Grep)
-   - Git, 패키지 관리자
-2. **정책/규칙**:
-   - CLAUDE.md (기술 스택, 아키텍처)
-   - .vibe/constitution.md (프로젝트 규칙)
-   - skills/ 폴더 (품질 기준, 코딩 표준)
-3. **메모리**:
-   - recall_memory (이전 세션 정보)
-   - restore_session_context (컨텍스트 복원)
-4. **사용자 확인**:
-   - 비즈니스 로직 세부사항
-   - 디자인 선호도
+    return `**정보 소스**:
+1. **도구**:
+   - MCP 도구 (hi-ai 38개 도구)
+   - 파일 시스템 (Read, Write, Edit, Glob, Grep)
+   - Git, 패키지 관리자
+2. **정책/규칙**:
+   - CLAUDE.md (기술 스택, 아키텍처)
+   - .vibe/constitution.md (프로젝트 규칙)
+   - skills/ 폴더 (품질 기준, 코딩 표준)
+3. **메모리**:
+   - recall_memory (이전 세션 정보)
+   - restore_session_context (컨텍스트 복원)
+4. **사용자 확인**:
+   - 비즈니스 로직 세부사항
+   - 디자인 선호도
    - 우선순위 결정`;
 }
 function ensurePrecision(problem, context) {
-    return `**정밀성 확보**:
-- 정책 인용: "CLAUDE.md:12에 따르면..." 형식으로 명시
-- 코드 참조: "users.py:45의 User 모델" 형식으로 파일명:라인 포함
-- 숫자 정확성: 복잡도, 커버리지, 성능 지표를 정확한 수치로 표현
+    return `**정밀성 확보**:
+- 정책 인용: "CLAUDE.md:12에 따르면..." 형식으로 명시
+- 코드 참조: "users.py:45의 User 모델" 형식으로 파일명:라인 포함
+- 숫자 정확성: 복잡도, 커버리지, 성능 지표를 정확한 수치로 표현
 - 근거 제시: 모든 주장에 대해 출처와 근거 명확히`;
 }
 function ensureCompleteness(problem, context) {
-    return `**완전성 확보**:
-- 충돌 해결: 정책 → 작업 순서 → 전제 조건 → 사용자 선호도 순
-- 옵션 탐색: 단일 해결책에 조기 고정하지 않고 여러 대안 검토
-- 정보 검토: 모든 관련 정보 소스(#5) 철저히 검토
+    return `**완전성 확보**:
+- 충돌 해결: 정책 → 작업 순서 → 전제 조건 → 사용자 선호도 순
+- 옵션 탐색: 단일 해결책에 조기 고정하지 않고 여러 대안 검토
+- 정보 검토: 모든 관련 정보 소스(#5) 철저히 검토
 - 사용자 확인: 불확실한 부분은 가정하지 말고 확인`;
 }
 function demonstratePersistence(problem, context) {
-    return `**끈기 전략**:
-- 일시적 오류: 지수 백오프로 재시도 (예: 1초, 2초, 4초...)
-- 한계 인식: 명확한 재시도 제한, 타임아웃 도달 시 중단
-- 전략 변경: 같은 실패 반복 X → 다른 접근법 시도
+    return `**끈기 전략**:
+- 일시적 오류: 지수 백오프로 재시도 (예: 1초, 2초, 4초...)
+- 한계 인식: 명확한 재시도 제한, 타임아웃 도달 시 중단
+- 전략 변경: 같은 실패 반복 X → 다른 접근법 시도
 - 철저한 분석: 시간이 걸리더라도 모든 추론 단계 완료`;
 }
 function planExecution(problem, context) {
-    return `**실행 계획**:
-1. **추론 문서화**: 복잡한 결정의 경우 추론 과정 간략히 설명
-2. **단계별 실행**: 한 번에 하나의 주요 행동만 수행
-3. **결과 확인**: 각 행동의 결과를 확인한 후 다음 단계로 진행
+    return `**실행 계획**:
+1. **추론 문서화**: 복잡한 결정의 경우 추론 과정 간략히 설명
+2. **단계별 실행**: 한 번에 하나의 주요 행동만 수행
+3. **결과 확인**: 각 행동의 결과를 확인한 후 다음 단계로 진행
 4. **롤백 대비**: 문제 발생 시 이전 상태로 복구 가능하도록 준비`;
 }
 function generateSummary(problem, steps) {
-    return `9단계 추론 프레임워크를 "${problem}"에 적용했습니다.
+    return `9단계 추론 프레임워크를 "${problem}"에 적용했습니다.
 총 ${steps.length}개 단계를 체계적으로 분석하여 논리적 종속성, 위험, 가설, 정보 소스를 포괄적으로 검토했습니다.`;
 }
 function formatOutput(result) {

package/dist/tools/semantic/analyzeDependencyGraph.js

@@ -2,18 +2,18 @@
 import { ProjectCache } from '../../lib/ProjectCache.js';
 export const analyzeDependencyGraphDefinition = {
     name: 'analyze_dependency_graph',
-    description: `코드 의존성 그래프를 분석합니다.
-
-키워드: 의존성, 관계 분석, 순환 참조, dependency graph, circular dependency
-
-**분석 내용:**
-- 파일 간 import/export 관계
-- 순환 의존성 감지
-- 모듈 클러스터 식별
-- 코드 결합도 분석
-
-사용 예시:
-- "src 폴더의 의존성 그래프 분석해줘"
+    description: `코드 의존성 그래프를 분석합니다.
+
+키워드: 의존성, 관계 분석, 순환 참조, dependency graph, circular dependency
+
+**분석 내용:**
+- 파일 간 import/export 관계
+- 순환 의존성 감지
+- 모듈 클러스터 식별
+- 코드 결합도 분석
+
+사용 예시:
+- "src 폴더의 의존성 그래프 분석해줘"
 - "index.ts의 의존 관계 보여줘"`,
     inputSchema: {
         type: 'object',