@su-record/vibe 2.2.2 → 2.2.3

package/package.json

@@ -1,66 +1,69 @@
-{
-  "name": "@su-record/vibe",
-  "version": "2.2.2",
-  "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
-  "type": "module",
-  "main": "dist/cli/index.js",
-  "bin": {
-    "vibe": "./dist/cli/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "ai",
-    "vibe",
-    "coding",
-    "spec-driven",
-    "claude",
-    "mcp",
-    "framework",
-    "requirements",
-    "user-story",
-    "ultrawork",
-    "parallel-agents",
-    "memory-management",
-    "knowledge-graph",
-    "code-analysis",
-    "code-quality"
-  ],
-  "author": "Su",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/su-record/vibe.git"
-  },
-  "homepage": "https://github.com/su-record/vibe#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "better-sqlite3": "^12.4.1",
-    "chalk": "^5.3.0",
-    "glob": "^11.0.3",
-    "ts-morph": "^26.0.0"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/glob": "^8.1.0",
-    "@types/node": "^22.0.0",
-    "typescript": "^5.5.4",
-    "vitest": "^4.0.9"
-  },
-  "files": [
-    "dist/",
-    ".claude/",
-    "templates/",
-    "CLAUDE.md",
-    "README.md",
-    "LICENSE"
-  ]
-}
+{
+  "name": "@su-record/vibe",
+  "version": "2.2.3",
+  "description": "Vibe - Claude Code exclusive SPEC-driven AI coding framework with 35+ integrated tools",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "vibe": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "vibe",
+    "coding",
+    "spec-driven",
+    "claude",
+    "mcp",
+    "framework",
+    "requirements",
+    "user-story",
+    "ultrawork",
+    "parallel-agents",
+    "memory-management",
+    "knowledge-graph",
+    "code-analysis",
+    "code-quality"
+  ],
+  "author": "Su",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/su-record/vibe.git"
+  },
+  "homepage": "https://github.com/su-record/vibe#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^12.4.1",
+    "chalk": "^5.3.0",
+    "glob": "^11.0.3",
+    "ts-morph": "^26.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/glob": "^8.1.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.4",
+    "vitest": "^4.0.9"
+  },
+  "files": [
+    "dist/",
+    ".claude/",
+    "commands/",
+    "agents/",
+    "skills/",
+    "templates/",
+    "CLAUDE.md",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/skills/git-worktree.md

@@ -0,0 +1,178 @@
+# Git Worktree Skill
+
+Git Worktree를 활용한 병렬 브랜치 작업 스킬
+
+## Overview
+
+메인 작업을 중단하지 않고 다른 브랜치에서 리뷰/테스트 수행
+
+## Usage
+
+```bash
+# Worktree 생성
+git worktree add ../review-pr123 pr/123
+
+# 해당 디렉토리에서 작업
+cd ../review-pr123
+npm test
+
+# 작업 완료 후 정리
+git worktree remove ../review-pr123
+```
+
+## Commands
+
+### Create Worktree
+
+```bash
+# PR 리뷰용 worktree
+git worktree add ../review-{pr_number} origin/pr/{pr_number}
+
+# 특정 브랜치 worktree
+git worktree add ../feature-work feature/new-feature
+
+# 새 브랜치로 worktree
+git worktree add -b hotfix/urgent ../hotfix main
+```
+
+### List Worktrees
+
+```bash
+git worktree list
+# /path/to/main       abc1234 [main]
+# /path/to/review-123 def5678 [pr/123]
+```
+
+### Remove Worktree
+
+```bash
+# 정상 제거
+git worktree remove ../review-123
+
+# 강제 제거 (uncommitted changes 무시)
+git worktree remove --force ../review-123
+
+# Prune stale worktrees
+git worktree prune
+```
+
+## Workflow Integration
+
+### PR Review Workflow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /vibe.review PR#123                                             │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. git worktree add ../review-123 origin/pr/123               │
+│  2. cd ../review-123                                            │
+│  3. npm install && npm test                                     │
+│  4. Run parallel review agents                                  │
+│  5. Generate review report                                      │
+│  6. cd - && git worktree remove ../review-123                  │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Hotfix Workflow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Urgent hotfix while working on feature                         │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  # Keep feature work intact                                     │
+│  git worktree add -b hotfix/critical ../hotfix main            │
+│  cd ../hotfix                                                   │
+│                                                                 │
+│  # Fix and deploy                                               │
+│  vim src/bug.py                                                 │
+│  git commit -am "fix: critical bug"                             │
+│  git push origin hotfix/critical                                │
+│                                                                 │
+│  # Return to feature                                            │
+│  cd - && git worktree remove ../hotfix                         │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Benefits
+
+1. **No Stash Needed**: 현재 작업 그대로 유지
+2. **Full Codebase**: 각 worktree는 완전한 코드베이스
+3. **Parallel Work**: 여러 브랜치 동시 작업
+4. **Clean Testing**: 격리된 환경에서 테스트
+
+## Best Practices
+
+### Naming Convention
+
+```bash
+# PR 리뷰
+../review-{pr_number}
+
+# 핫픽스
+../hotfix-{issue_number}
+
+# 실험
+../experiment-{feature_name}
+```
+
+### Cleanup
+
+```bash
+# 정기 정리
+git worktree prune
+
+# 모든 worktree 확인
+git worktree list
+
+# 스크립트로 자동 정리
+for wt in $(git worktree list --porcelain | grep worktree | cut -d' ' -f2); do
+  if [[ $wt == *"review-"* ]] || [[ $wt == *"hotfix-"* ]]; then
+    git worktree remove "$wt" 2>/dev/null || true
+  fi
+done
+```
+
+### Integration with CI/CD
+
+```yaml
+# GitHub Actions example
+- name: Setup Review Worktree
+  run: |
+    git fetch origin pull/${{ github.event.pull_request.number }}/head:pr-${{ github.event.pull_request.number }}
+    git worktree add ../review pr-${{ github.event.pull_request.number }}
+
+- name: Run Tests in Worktree
+  working-directory: ../review
+  run: npm test
+
+- name: Cleanup
+  run: git worktree remove ../review
+```
+
+## Troubleshooting
+
+### "already checked out" Error
+
+```bash
+# 해결: 해당 브랜치가 다른 worktree에 있음
+git worktree list  # 확인
+git worktree remove <path>  # 제거
+```
+
+### Locked Worktree
+
+```bash
+# 해결: 잠긴 worktree 해제
+git worktree unlock <path>
+```
+
+### Stale Worktree
+
+```bash
+# 해결: 삭제된 디렉토리 정리
+git worktree prune
+```

package/skills/priority-todos.md

@@ -0,0 +1,236 @@
+# Priority-Based Todo Management Skill
+
+우선순위 기반 TODO 관리 시스템
+
+## Overview
+
+P1/P2/P3 우선순위로 태스크를 분류하여 중요한 것 먼저 처리
+
+## Priority Levels
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Priority Levels                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  🔴 P1 (Critical)                                               │
+│  ├── 보안 취약점                                                 │
+│  ├── 데이터 손실 위험                                            │
+│  ├── 프로덕션 장애                                               │
+│  └── 머지 차단 이슈                                              │
+│                                                                 │
+│  🟡 P2 (Important)                                              │
+│  ├── 성능 문제                                                   │
+│  ├── 테스트 누락                                                 │
+│  ├── 아키텍처 위반                                               │
+│  └── 기술 부채                                                   │
+│                                                                 │
+│  🔵 P3 (Nice-to-have)                                           │
+│  ├── 코드 스타일                                                 │
+│  ├── 리팩토링 제안                                               │
+│  ├── 문서화                                                      │
+│  └── 최적화 기회                                                 │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## File-Based Todo System
+
+### Directory Structure
+
+```
+.claude/vibe/todos/
+├── P1-security-sql-injection.md
+├── P1-data-transaction-missing.md
+├── P2-perf-n1-query.md
+├── P2-test-missing-edge-case.md
+├── P2-arch-circular-dependency.md
+├── P3-style-extract-helper.md
+├── P3-docs-add-readme.md
+└── index.md
+```
+
+### Todo File Format
+
+```markdown
+# [P1] SQL Injection Vulnerability
+
+## Summary
+User input directly concatenated in SQL query without sanitization.
+
+## Priority Justification
+- 🔴 P1 (Critical)
+- Category: Security
+- Impact: High (data breach risk)
+- Effort: Low (simple fix)
+
+## Location
+- **File**: src/api/users.py
+- **Line**: 42-45
+- **Function**: `get_user_by_email()`
+
+## Current Code
+```python
+def get_user_by_email(email: str):
+    query = f"SELECT * FROM users WHERE email = '{email}'"
+    return db.execute(query)
+```
+
+## Suggested Fix
+```python
+def get_user_by_email(email: str):
+    query = "SELECT * FROM users WHERE email = %s"
+    return db.execute(query, (email,))
+```
+
+## Checklist
+- [ ] Fix implemented
+- [ ] Unit test added
+- [ ] Security test added
+- [ ] Code reviewed
+- [ ] Merged
+
+## References
+- OWASP SQL Injection: https://owasp.org/www-community/attacks/SQL_Injection
+- Project Security Guide: docs/security.md
+
+## Metadata
+- Created: 2026-01-11
+- Author: Claude
+- Review: /vibe.review PR#123
+```
+
+### Index File
+
+```markdown
+# Todo Index
+
+## Summary
+| Priority | Count | Status |
+|----------|-------|--------|
+| 🔴 P1 | 2 | 🚨 Blocks merge |
+| 🟡 P2 | 5 | ⚠️ Should fix |
+| 🔵 P3 | 3 | 💡 Backlog |
+
+## 🔴 P1 Critical (Blocks Merge)
+
+| # | Title | Location | Status |
+|---|-------|----------|--------|
+| 1 | SQL Injection | users.py:42 | ❌ Open |
+| 2 | Missing Rollback | payment.py:128 | ❌ Open |
+
+## 🟡 P2 Important
+
+| # | Title | Location | Status |
+|---|-------|----------|--------|
+| 3 | N+1 Query | orders.py:78 | ❌ Open |
+| 4 | Missing Tests | auth.py | ❌ Open |
+| 5 | Circular Dep | services/ | ❌ Open |
+
+## 🔵 P3 Nice-to-have
+
+| # | Title | Location | Status |
+|---|-------|----------|--------|
+| 6 | Extract Helper | utils.py:45 | 💤 Backlog |
+| 7 | Add README | /payment | 💤 Backlog |
+
+---
+
+Last updated: 2026-01-11 10:30
+```
+
+## Workflow Commands
+
+### Create Todo
+
+```bash
+# /vibe.review 결과에서 자동 생성
+/vibe.review PR#123
+# → .claude/vibe/todos/ 에 파일 생성
+
+# 수동 생성
+vibe todo add "SQL Injection in users.py" --priority P1 --category security
+```
+
+### List Todos
+
+```bash
+# 전체 목록
+vibe todo list
+
+# 우선순위별
+vibe todo list --priority P1
+vibe todo list --priority P2
+
+# 카테고리별
+vibe todo list --category security
+vibe todo list --category performance
+```
+
+### Complete Todo
+
+```bash
+# 완료 처리
+vibe todo done P1-security-sql-injection
+
+# 파일에 체크 표시 + index 업데이트
+```
+
+### Clean Up
+
+```bash
+# 완료된 항목 아카이브
+vibe todo archive
+
+# 결과:
+# .claude/vibe/todos/P1-security-sql-injection.md
+# → .claude/vibe/todos/done/2026-01-11-P1-security-sql-injection.md
+```
+
+## Integration with TodoWrite
+
+기존 TodoWrite 도구와 연동:
+
+```javascript
+TodoWrite({
+  todos: [
+    {
+      content: "[P1] Fix SQL injection in users.py:42",
+      status: "in_progress",
+      activeForm: "Fixing SQL injection vulnerability",
+      priority: "P1",  // 확장 필드
+      category: "security"  // 확장 필드
+    },
+    {
+      content: "[P2] Add missing tests for auth",
+      status: "pending",
+      activeForm: "Adding auth tests",
+      priority: "P2",
+      category: "testing"
+    }
+  ]
+})
+```
+
+## Auto-Blocking Rules
+
+```yaml
+# .claude/vibe/config.yaml
+merge_blocking:
+  P1: true   # P1 있으면 머지 차단
+  P2: false  # P2는 경고만
+  P3: false  # P3는 무시
+
+notifications:
+  P1: immediate  # 즉시 알림
+  P2: daily      # 일일 요약
+  P3: weekly     # 주간 요약
+```
+
+## Best Practices
+
+1. **P1은 즉시 처리**: 다른 작업 중단하고 수정
+2. **P2는 PR 전 처리**: 머지 전 해결 권장
+3. **P3는 백로그**: 시간 날 때 처리
+4. **정기 정리**: 주 1회 todo 리뷰
+5. **완료 기록**: 해결 방법 문서화