clouvel 0.3.1__py3-none-any.whl → 0.6.3__py3-none-any.whl

clouvel/tools/verify.py

@@ -0,0 +1,212 @@
+# -*- coding: utf-8 -*-
+"""Verify tools (v0.5): verify, gate, handoff"""
+
+from pathlib import Path
+from datetime import datetime
+from mcp.types import TextContent
+
+
+async def verify(path: str, scope: str, checklist: list) -> list[TextContent]:
+    """Context Bias 제거 검증"""
+    # 기본 체크리스트
+    default_checklist = {
+        "file": [
+            "함수가 단일 책임을 가지는가?",
+            "에러 처리가 되어 있는가?",
+            "타입이 명시되어 있는가?",
+        ],
+        "feature": [
+            "PRD에 명시된 기능인가?",
+            "엣지 케이스가 처리되어 있는가?",
+            "테스트가 작성되어 있는가?",
+        ],
+        "full": [
+            "모든 필수 문서가 업데이트되었는가?",
+            "보안 취약점이 없는가?",
+            "성능 이슈가 없는가?",
+            "접근성이 고려되었는가?",
+        ],
+    }
+
+    active_checklist = checklist if checklist else default_checklist.get(scope, default_checklist["file"])
+    checklist_md = "\n".join(f"- [ ] {item}" for item in active_checklist)
+
+    return [TextContent(type="text", text=f"""# Context Bias 제거 검증
+
+## 검증 대상
+`{path}`
+
+## 검증 범위
+**{scope}**
+
+---
+
+## ⚠️ 중요
+
+**같은 세션에서 작성한 코드를 검증하면 문제를 못 봅니다.**
+
+### 권장 절차
+1. `/clear` 실행 (컨텍스트 초기화)
+2. 아래 체크리스트로 검증
+3. 문제 발견 시 수정
+
+---
+
+## 체크리스트
+
+{checklist_md}
+
+---
+
+## 검증 후
+
+- 모든 항목 통과 → `gate` 도구로 자동 검증
+- 실패 항목 있음 → 수정 후 재검증
+
+**"/clear 후 다시 보면 다르게 보인다"**
+""")]
+
+
+async def gate(path: str, steps: list, fix: bool) -> list[TextContent]:
+    """Gate 검증 자동화"""
+    project_path = Path(path)
+
+    if not project_path.exists():
+        return [TextContent(type="text", text=f"❌ 경로가 존재하지 않습니다: {path}")]
+
+    # 기본 단계
+    default_steps = ["lint", "test", "build"]
+    active_steps = steps if steps else default_steps
+
+    # 단계별 명령어 (예시)
+    step_commands = {
+        "lint": "npm run lint || pylint . || ruff check .",
+        "test": "npm test || pytest || go test ./...",
+        "build": "npm run build || python -m build || go build",
+    }
+
+    steps_md = ""
+    for i, step in enumerate(active_steps, 1):
+        cmd = step_commands.get(step, step)
+        steps_md += f"{i}. **{step}**\n   ```\n   {cmd}\n   ```\n\n"
+
+    # EVIDENCE.md 템플릿
+    evidence_template = f"""# Gate 검증 결과
+
+> 검증일: {datetime.now().strftime('%Y-%m-%d %H:%M')}
+> 경로: {path}
+
+## 단계별 결과
+
+| 단계 | 결과 | 비고 |
+|------|------|------|
+{chr(10).join(f'| {s} | ⏳ | |' for s in active_steps)}
+
+## 자동 수정
+{'활성화' if fix else '비활성화'}
+
+---
+
+모든 단계 PASS 시 "완료" 처리
+"""
+
+    # EVIDENCE.md 생성
+    evidence_file = project_path / "EVIDENCE.md"
+    evidence_file.write_text(evidence_template, encoding='utf-8')
+
+    return [TextContent(type="text", text=f"""# Gate 검증 시작
+
+## 검증 단계
+
+{steps_md}
+
+## EVIDENCE.md
+`{evidence_file}` 에 결과가 기록됩니다.
+
+---
+
+## 실행 방법
+
+각 단계를 순서대로 실행하고 결과를 기록하세요.
+
+{'lint 에러는 자동 수정을 시도합니다.' if fix else ''}
+
+**모든 단계 PASS = 완료!**
+""")]
+
+
+async def handoff(path: str, feature: str, decisions: str, warnings: str, next_steps: str) -> list[TextContent]:
+    """의도 기록"""
+    project_path = Path(path)
+
+    if not project_path.exists():
+        return [TextContent(type="text", text=f"❌ 경로가 존재하지 않습니다: {path}")]
+
+    handoffs_dir = project_path / ".claude" / "handoffs"
+    handoffs_dir.mkdir(parents=True, exist_ok=True)
+
+    # 파일명 생성
+    timestamp = datetime.now().strftime('%Y-%m-%d')
+    safe_feature = feature.replace(" ", "-").replace("/", "-")[:30]
+    handoff_file = handoffs_dir / f"{timestamp}_{safe_feature}.md"
+
+    content = f"""# Handoff: {feature}
+
+> 작성일: {datetime.now().strftime('%Y-%m-%d %H:%M')}
+> 경로: {path}
+
+---
+
+## 완료한 작업
+
+{feature}
+
+---
+
+## 주요 결정사항 (왜 이렇게 했는지)
+
+{decisions if decisions else '(기록 필요)'}
+
+---
+
+## 주의할 점
+
+{warnings if warnings else '(없음)'}
+
+---
+
+## 다음에 해야 할 것
+
+{next_steps if next_steps else '(없음)'}
+
+---
+
+## Context Bias 제거 권장
+
+이 기록을 남긴 후:
+1. `/clear` 실행 또는 새 세션 시작
+2. `verify` 도구로 검증
+3. `gate` 도구로 최종 확인
+4. 커밋
+
+"""
+    handoff_file.write_text(content, encoding='utf-8')
+
+    return [TextContent(type="text", text=f"""# Handoff 기록 완료
+
+## 기록 위치
+`{handoff_file}`
+
+## 요약
+
+| 항목 | 내용 |
+|------|------|
+| 기능 | {feature} |
+| 결정사항 | {decisions[:50] + '...' if decisions and len(decisions) > 50 else decisions or '없음'} |
+| 주의사항 | {warnings[:50] + '...' if warnings and len(warnings) > 50 else warnings or '없음'} |
+| 다음 단계 | {next_steps[:50] + '...' if next_steps and len(next_steps) > 50 else next_steps or '없음'} |
+
+---
+
+**다음 작업자(또는 미래의 나)를 위한 기록이 저장되었습니다.**
+""")]

clouvel-0.6.3.dist-info/METADATA

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: clouvel
+Version: 0.6.3
+Summary: 바이브코딩 프로세스를 강제하는 MCP 서버 - PRD 없으면 코딩 없다
+Project-URL: Homepage, https://github.com/Whitening-Sinabro/clouvel
+Project-URL: Repository, https://github.com/Whitening-Sinabro/clouvel
+Project-URL: Issues, https://github.com/Whitening-Sinabro/clouvel/issues
+Author: SINABRO
+License-Expression: MIT
+Keywords: documentation,mcp,prd,vibe-coding
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# Clouvel
+
+> **PRD 없으면 코딩 없다.**
+
+바이브코딩 프로세스를 강제하는 MCP 서버.
+문서 없이 코딩 시작? 차단됩니다.
+
+---
+
+## 설치
+
+```bash
+pip install clouvel
+```
+
+---
+
+## Claude Code 연동
+
+`claude_desktop_config.json`에 추가:
+
+```json
+{
+  "mcpServers": {
+    "clouvel": {
+      "command": "uvx",
+      "args": ["clouvel"]
+    }
+  }
+}
+```
+
+---
+
+## 도구 목록 (23개)
+
+### Core (4개)
+
+| 도구 | 설명 |
+|------|------|
+| `can_code` | 코딩 가능? PRD 있어야 허용 |
+| `scan_docs` | docs 폴더 파일 목록 |
+| `analyze_docs` | 필수 문서 체크 |
+| `init_docs` | docs 폴더 + 템플릿 생성 |
+
+**예시: can_code**
+```
+You: "로그인 기능 만들어줘"
+Claude: can_code 호출...
+
+❌ 코딩 차단
+- PRD.md 없음
+- Architecture.md 없음
+💡 먼저 PRD를 작성하세요.
+```
+
+---
+
+### Docs (6개)
+
+| 도구 | 설명 |
+|------|------|
+| `get_prd_template` | PRD 템플릿 생성 |
+| `write_prd_section` | PRD 섹션별 가이드 |
+| `get_prd_guide` | PRD 작성 전체 가이드 |
+| `get_verify_checklist` | 검증 체크리스트 |
+| `get_setup_guide` | 플랫폼별 설정 가이드 |
+| `get_analytics` | 사용량 통계 |
+
+**예시: get_analytics**
+```
+📊 최근 7일 사용 통계
+- can_code: 23회
+- gate: 8회
+- Gate 통과율: 85%
+```
+
+---
+
+### Setup (2개)
+
+| 도구 | 설명 |
+|------|------|
+| `init_clouvel` | 온보딩 (플랫폼 선택) |
+| `setup_cli` | CLI 환경 설정 |
+
+**예시: setup_cli**
+```
+You: "strict 모드로 설정해줘"
+
+⚙️ CLI 설정 완료
+- CLAUDE.md 생성됨
+- pre-commit 훅 설치됨
+- PRD 없으면 커밋 차단
+```
+
+---
+
+### Rules - v0.5 (3개)
+
+| 도구 | 설명 |
+|------|------|
+| `init_rules` | 규칙 파일 생성 |
+| `get_rule` | 파일별 적용 규칙 조회 |
+| `add_rule` | 새 규칙 추가 |
+
+**예시: get_rule**
+```
+You: "auth.ts 수정하려는데 규칙 뭐야?"
+
+📜 auth.ts 적용 규칙
+NEVER:
+- 비밀번호 평문 저장
+- JWT 시크릿 하드코딩
+ALWAYS:
+- bcrypt로 해싱
+```
+
+---
+
+### Verify - v0.5 (3개)
+
+| 도구 | 설명 |
+|------|------|
+| `verify` | Context Bias 제거 검증 |
+| `gate` | lint → test → build 자동화 |
+| `handoff` | 의도 기록 (다음 세션용) |
+
+**예시: gate**
+```
+You: "gate 돌려줘"
+
+🚦 Gate 실행
+1. Lint... ✅
+2. Test... ✅ (12/12)
+3. Build.. ✅
+🎉 Gate PASS - 커밋 가능!
+```
+
+**예시: handoff**
+```
+You: "로그인 기능 끝났어"
+
+📋 핸드오프 저장됨
+- 기능: 로그인
+- 결정: JWT 선택
+- 주의: refresh token 미구현
+- 다음: 회원가입
+```
+
+---
+
+### Planning - v0.6 (4개)
+
+| 도구 | 설명 |
+|------|------|
+| `init_planning` | 작업 목표 설정 |
+| `save_finding` | 조사 결과 저장 |
+| `refresh_goals` | 목표 리마인드 |
+| `update_progress` | 진행 상황 업데이트 |
+
+**예시: refresh_goals**
+```
+You: "지금 뭐하고 있었지?"
+
+🎯 현재 목표
+작업: 결제 시스템
+
+✅ Stripe 연동
+🔄 웹훅 처리 (진행 중)
+⬚ 영수증 발송
+
+진행률: 33%
+```
+
+---
+
+### Agents - v0.7 (2개)
+
+| 도구 | 설명 |
+|------|------|
+| `spawn_explore` | 코드베이스 탐색 |
+| `spawn_librarian` | 외부 문서/API 조사 |
+
+**예시: spawn_explore**
+```
+You: "인증 로직 어디있어?"
+
+🔍 탐색 결과
+- src/lib/auth.ts (메인)
+- src/middleware/auth.ts
+- src/api/auth/route.ts
+```
+
+**예시: spawn_librarian**
+```
+You: "Next.js 15 바뀐거 조사해줘"
+
+📚 조사 결과
+- async/await 서버 컴포넌트 기본
+- 새 캐싱 전략
+- Turbopack 안정화
+출처: Next.js 공식 문서
+```
+
+---
+
+### Hooks - v0.8 (2개)
+
+| 도구 | 설명 |
+|------|------|
+| `hook_design` | 코딩 전 자동 체크 |
+| `hook_verify` | 코딩 후 자동 검증 |
+
+**예시: hook_verify**
+```
+You: "커밋 전에 자동으로 검사하게 해줘"
+
+🪝 검증 훅 생성됨
+트리거: pre_commit
+단계: lint, test
+실패 시: 커밋 차단
+```
+
+---
+
+## Pro 버전
+
+더 강력한 기능이 필요하다면 **Clouvel Pro**를 확인하세요.
+
+- **Shovel 워크플로우** 자동 설치
+- **에러 학습 시스템**
+- **Context 관리 도구**
+
+**[Clouvel Pro 보러가기](https://whitening-sinabro.github.io/clouvel/)**
+
+---
+
+## 링크
+
+- [GitHub](https://github.com/Whitening-Sinabro/clouvel)
+- [Landing Page](https://whitening-sinabro.github.io/clouvel/)
+- [Issues](https://github.com/Whitening-Sinabro/clouvel/issues)
+
+---
+
+## 라이선스
+
+MIT

clouvel-0.6.3.dist-info/RECORD

@@ -0,0 +1,16 @@
+clouvel/__init__.py,sha256=kd5Da6RpqW39wTlqulTHiEdOPNmPaxxs4Ke14XeuyIg,45
+clouvel/analytics.py,sha256=thAbz1zHL8XV56T8dNbeIrebgI5MpA5hUyV_Wm5suLU,4456
+clouvel/server.py,sha256=Sq091oNbIFBlj-cTK6-k3LHlj-PAxBE3vJPUO1oGAoc,23647
+clouvel/tools/__init__.py,sha256=kwEmKiyDohhDjkm65G8nG6shxm9gY_K6HG0u3LEL-oI,1412
+clouvel/tools/agents.py,sha256=W6xvg2-QUIOGm_7xOio1bsXikn-0NlMGh-ifaoG7yJY,6949
+clouvel/tools/core.py,sha256=YMkK0pcFaionFFzVMoO31WdjEvGwPbUhSrL4BKGA86I,11939
+clouvel/tools/docs.py,sha256=JS3idaEFNggM4II5cv2CLA99Q3G-TBHZWyrBcDStiEQ,6031
+clouvel/tools/hooks.py,sha256=F3clvkkMaTIb4hdjsiLCNz-c1s2eo3e31ObftzzIFd4,5269
+clouvel/tools/planning.py,sha256=1VMLypxgf506vEAUhjmDxkyBmiWlr27Mc2OLIX2D-NE,7360
+clouvel/tools/rules.py,sha256=0zWlVSv94vwM11FnyjXnEiaykzfuYEEuWMWjZNpIXe8,6140
+clouvel/tools/setup.py,sha256=HltxSRxOy9pV0ozvJifFEdR_08Cf_d3IC1DOtO3p-1E,4888
+clouvel/tools/verify.py,sha256=1ZBFP62FaDYALII_bWBrUj2I4gOjEqieEDizUVu1UPo,5291
+clouvel-0.6.3.dist-info/METADATA,sha256=FSttvhA30ocvpmTNpnDektAvNG9Ds00RTU44V2FX1-4,5204
+clouvel-0.6.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+clouvel-0.6.3.dist-info/entry_points.txt,sha256=OvZ_fGmyJXE-9o54QYRRbGt4CCsm_u5r-9Bnc0BdquE,41
+clouvel-0.6.3.dist-info/RECORD,,

clouvel-0.3.1.dist-info/METADATA

@@ -1,80 +0,0 @@
-Metadata-Version: 2.4
-Name: clouvel
-Version: 0.3.1
-Summary: 바이브코딩 프로세스를 강제하는 MCP 서버
-Project-URL: Homepage, https://github.com/sinabro/clouvel
-Project-URL: Repository, https://github.com/sinabro/clouvel
-Author: SINABRO
-License-Expression: MIT
-Keywords: documentation,mcp,prd,vibe-coding
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.11
-Requires-Dist: mcp>=1.0.0
-Requires-Dist: pydantic>=2.0.0
-Description-Content-Type: text/markdown
-
-# Clouvel
-
-바이브코딩 프로세스를 강제하는 MCP 서버.
-
-코딩 전에 PRD 검증부터.
-
-## 설치
-
-Claude Desktop 설정 (`claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "clouvel": {
-      "command": "uvx",
-      "args": ["clouvel"]
-    }
-  }
-}
-```
-
-끝. pip install 필요 없음.
-
-## 제공 도구
-
-| 도구 | 설명 |
-|------|------|
-| `scan_docs` | docs 폴더 파일 목록 |
-| `analyze_docs` | 필수 문서 체크. 빠진 거 알려줌 |
-| `get_prd_guide` | PRD 작성 가이드 |
-| `get_verify_checklist` | 검증 체크리스트 |
-
-## 사용법
-
-Claude한테:
-- "이 프로젝트 docs 검증해줘"
-- "PRD 어떻게 써야 해?"
-- "검증 체크리스트 보여줘"
-
-## 필수 문서
-
-`analyze_docs`가 체크하는 것들:
-
-- PRD (제품 요구사항)
-- 아키텍처 문서
-- API 스펙
-- DB 스키마
-- 검증 계획
-
-다 있어야 "바이브코딩 시작해도 됨" 나옴.
-
-## 왜?
-
-바이브코딩 = AI가 코드 짬.
-근데 PRD 없이 시작하면 = 나중에 다 뜯어고침.
-
-Clouvel = 문서 없으면 코딩 못 하게 강제.
-
-## License
-
-MIT

clouvel-0.3.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-clouvel/__init__.py,sha256=kd5Da6RpqW39wTlqulTHiEdOPNmPaxxs4Ke14XeuyIg,45
-clouvel/server.py,sha256=5ROWIMKoGmjknx1JdtWzDd2UnkfAWwylwf33dhVW-rk,30698
-clouvel-0.3.1.dist-info/METADATA,sha256=dOjQLN-RIN-X1jabrNvCZ1-I6WtGe9ZTs4ntc0sbj2c,1775
-clouvel-0.3.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-clouvel-0.3.1.dist-info/entry_points.txt,sha256=OvZ_fGmyJXE-9o54QYRRbGt4CCsm_u5r-9Bnc0BdquE,41
-clouvel-0.3.1.dist-info/RECORD,,