@vibecodetown/mcp-server 2.1.4 → 2.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecodetown/mcp-server",
-  "version": "2.1.4",
+  "version": "2.2.1",
   "type": "module",
   "description": "Vibe PM - AI Project Manager MCP Server for non-technical founders",
   "keywords": [
@@ -27,13 +27,13 @@
     "node": ">=18"
   },
   "bin": {
-    "mcp-server": "build/index.js",
-    "vibecode-mcp": "build/index.js",
-    "vibe": "build/vibe-cli.js"
+    "vibecode-mcp": "./build/index.js",
+    "vibe": "./build/vibe-cli.js"
   },
   "main": "./build/index.js",
   "files": [
     "build/",
+    "skills/",
     "README.md",
     "LICENSE"
   ],
@@ -57,6 +57,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@msgpack/msgpack": "^3.1.3",
     "minimatch": "^9.0.3",
     "node-notifier": "^10.0.1",
     "simple-git": "^3.30.0",

package/skills/VRIP_INSTALL_MANIFEST_DOCTOR.skill.md

@@ -0,0 +1,288 @@
+# Skill: VRIP + install_manifest + doctor 운영 스킬 v1
+
+> **Version**: 1.0.0
+> **Target**: Claude Code / Codex CLI / Cursor
+> **Created**: 2026-01-24
+
+## 0) 이 스킬의 목표
+
+* MCP↔CLI↔Daemon이 **설치 상태/실행 상태**를 헷갈리지 않게 강제한다.
+* `.vibe/install_manifest.json`을 **설치 SSOT**로 유지한다.
+* `vibe doctor`로 **Gate 판정(PASS/WARN/FAIL)** 을 일관되게 만든다.
+* MCP는 "읽기 전용" 규칙을 어기지 않는다.
+
+---
+
+## 1) 입력 (Input)
+
+사용자가 아래 중 하나를 요청하면 이 스킬을 실행한다.
+
+* "설치 상태 확인해줘"
+* "왜 MCP는 되는데 로컬이 안 돼?"
+* "엔진 버전 꼬였나?"
+* "doctor 결과 이상함"
+* "manifest 스키마/권한/갱신 규칙 적용"
+* "MCP가 로컬을 안 쓰는 느낌인데?"
+
+---
+
+## 2) 출력 (Output)
+
+항상 아래 3가지를 반환한다.
+
+1. **현재 상태 요약**: 설치/엔진/데몬/무결성
+2. **Gate 결과**: PASS/WARN/FAIL + 코드 목록
+3. **즉시 실행 커맨드**: `vibe doctor`, `vibe update`, `vibe exec status` 등 최소 세트
+
+---
+
+## 3) 핵심 규칙 (Law 요약)
+
+| 규칙 | 설명 |
+|------|------|
+| MCP는 manifest를 **절대 쓰지 않는다** | 읽기 전용 |
+| 설치/엔진 상태 갱신 | **vibe update만** |
+| 진단 요약 갱신 | **vibe doctor만** |
+| 데몬 생존 갱신 | **vibe exec --daemon만** |
+| 결과의 SSOT | **run_dir** |
+| 설치의 SSOT | **install_manifest** |
+
+---
+
+## 4) 실행 절차 (Step-by-step)
+
+### Step 1) manifest 존재/파싱
+
+* 파일: `.vibe/install_manifest.json`
+* 없으면:
+  * **FAIL: MANIFEST_MISSING**
+  * 다음 액션: `vibe update` (설치/생성 담당)
+
+### Step 2) doctor로 Gate 판정 생성
+
+* 실행: `vibe doctor --json`
+* 결과를 `integrity.doctor_summary`로 기록(doctor가 쓰는 유일한 영역)
+
+### Step 3) engines/components 점검(doctor 결과 기반)
+
+* `status != ok`인 엔진 있으면:
+  * **FAIL** (sha_mismatch, missing, wrong_platform, permission_denied)
+  * 다음 액션: `vibe update --engine <name>` 또는 `vibe update`
+
+### Step 4) bins 점검
+
+* `bins.vibe.ok == false` → FAIL
+* `bins.mcp_server.ok == false` → FAIL
+* 다음 액션: 패키지 재설치 or update 루틴
+
+### Step 5) 데몬 상태(선택)
+
+* `vibe exec status --json`
+* lock stale이면:
+  * WARN 또는 FAIL(운영 정책에 따라)
+* 다음 액션: `vibe exec stop` 후 재기동
+
+---
+
+## 5) Gate 체크리스트 (표준 코드)
+
+doctor는 반드시 아래 코드 체계를 써라(이름 통일이 중요).
+
+### FAIL (즉시 중단/수리 필요)
+
+| 코드 | 설명 |
+|------|------|
+| `MANIFEST_MISSING` | manifest 파일 없음 |
+| `MANIFEST_SCHEMA_INVALID` | manifest 스키마 검증 실패 |
+| `BIN_VIBE_MISSING` | vibe CLI 바이너리 없음 |
+| `BIN_MCP_SERVER_MISSING` | MCP 서버 바이너리 없음 |
+| `ENGINE_MISSING:<name>` | 특정 엔진 없음 |
+| `ENGINE_SHA_MISMATCH:<name>` | 엔진 SHA256 불일치 |
+| `ENGINE_WRONG_PLATFORM:<name>` | 플랫폼 불일치 |
+| `ENGINE_PERMISSION_DENIED:<name>` | 엔진 실행 권한 없음 |
+| `RUN_ROOT_UNWRITABLE` | runs 디렉토리 쓰기 불가 |
+| `DAEMON_MISCONFIGURED` | 데몬 설정 오류 |
+
+### WARN (기능은 되지만 위험)
+
+| 코드 | 설명 |
+|------|------|
+| `PKG_VERSION_MISMATCH` | 패키지 버전 불일치 |
+| `DAEMON_STALE_LOCK` | 데몬 lock 파일 stale |
+| `RUN_ROOT_CONFLICT_SUSPECTED` | run_dir 충돌 의심 |
+
+### INFO
+
+| 코드 | 설명 |
+|------|------|
+| `DAEMON_NOT_USED` | 데몬 미사용 |
+| `CACHE_OK` | 캐시 정상 |
+| `ENGINE_OK:<name>` | 특정 엔진 정상 |
+
+---
+
+## 6) 표준 커맨드 세트 (복붙용)
+
+### 설치/동기화(SSOT 생성/갱신)
+
+```bash
+vibe update
+```
+
+### 진단(Gate 판정)
+
+```bash
+vibe doctor --json
+```
+
+### 데몬 상태
+
+```bash
+vibe exec status --json
+```
+
+### 데몬 기동(운영)
+
+```bash
+vibe exec --daemon --config .vibe/exec/config.json
+```
+
+---
+
+## 7) MCP 구현자 규칙 (Wrapper 안전 패턴)
+
+MCP 도구는 다음만 한다.
+
+1. `vibe <command>` 호출 (필수)
+2. run_dir / manifest 읽기
+3. 해석/요약/다음 액션 제시
+
+**금지**
+
+* `.vibe/install_manifest.json` 쓰기
+* `.vibe/runs/**` 쓰기
+* 엔진 바이너리 직접 호출
+
+---
+
+## 8) 실패 유형별 즉시 처방 (Playbook)
+
+### 케이스 A) "MCP는 되는데 로컬이 안 돼"
+
+**증상**: MCP 도구는 동작하지만 CLI가 안 됨
+
+**진단**:
+```bash
+vibe doctor --json | jq '.engines'
+```
+
+**처방**:
+1. doctor 결과에서 `BIN_VIBE_MISSING` / `ENGINE_MISSING` 찾기
+2. `vibe update` 실행
+3. 여전히 안 되면 권한/플랫폼 mismatch 분기
+
+### 케이스 B) "JSON 파싱/출력 때문에 터짐"
+
+**증상**: stdout JSON 파싱 실패
+
+**규칙**:
+* stdout JSON을 결과로 쓰지 말고(run_dir SSOT)
+* CLI stdout은 `run_id` 같은 control 데이터만
+* MCP는 run_dir 파일을 읽어라
+
+**처방**:
+```bash
+# 잘못된 방식
+result=$(vibe inspect_code --json)  # stdout 파싱 X
+
+# 올바른 방식
+vibe inspect_code
+cat runs/<run_id>/result.json  # run_dir에서 읽기
+```
+
+### 케이스 C) "daemon.lock 때문에 꼬임"
+
+**증상**: `DAEMON_STALE_LOCK` 발생
+
+**처방**:
+```bash
+vibe exec stop
+rm -f .vibe/exec/daemon.lock  # lock 정리
+vibe exec --daemon --config .vibe/exec/config.json
+```
+
+---
+
+## 9) 스킬 완료 조건 (Done Criteria)
+
+아래를 만족해야 완료로 간주한다.
+
+- [ ] `.vibe/install_manifest.json` 존재 + 스키마 통과
+- [ ] `vibe doctor --json` 결과가 ok=true 또는 WARN만
+- [ ] engines/components가 모두 `status=ok` (또는 정책상 허용된 일부만 WARN)
+- [ ] MCP는 "읽기 전용" 규칙을 위반하지 않음
+
+---
+
+## 10) 스킬이 요구하는 파일(SSOT)
+
+| 파일 | 필수 | 설명 |
+|------|------|------|
+| `.vibe/install_manifest.json` | ✅ | 설치 상태 SSOT |
+| `schemas/install_manifest.schema.v1.json` | ✅ | manifest 스키마 |
+| `docs/ssot/INSTALL_MANIFEST_AUTHORITY_RULES.v1.md` | 선택 | 권한 규칙 |
+| `docs/ssot/VRIP.md` | 선택 | VRIP 프로토콜 |
+
+---
+
+## 11) 에이전트용 프롬프트 템플릿
+
+사용자가 상황을 설명하면 아래 템플릿으로 진단하라.
+
+### 입력 템플릿
+
+```
+## 현재 상황
+[사용자가 설명한 문제]
+
+## doctor 결과
+[vibe doctor --json 출력 붙여넣기]
+
+## manifest 상태
+[cat .vibe/install_manifest.json 출력 또는 "없음"]
+```
+
+### 출력 템플릿
+
+```
+## Gate 판정
+- **Status**: PASS / WARN / FAIL
+- **코드**: [해당 코드 목록]
+
+## 원인 분석
+[문제의 근본 원인]
+
+## 즉시 실행 커맨드
+```bash
+[복사 가능한 커맨드]
+```
+
+## 수정 체크리스트
+- [ ] [필요한 조치 1]
+- [ ] [필요한 조치 2]
+```
+
+---
+
+## 12) 관련 문서
+
+| 문서 | 역할 |
+|------|------|
+| `docs/ssot/VRIP.md` | Vibe Run Invocation Protocol |
+| `docs/ssot/INSTALL_MANIFEST_AUTHORITY_RULES.v1.md` | manifest 권한 규칙 |
+| `docs/DEV_SPEC/system_design_mapping/VIBE_PM_CONTROL_PLANE_SPEC.md` | Control Plane 스펙 |
+| `adapters/mcp-ts/src/tools/vibe_pm/doctor.ts` | doctor MCP 도구 |
+
+---
+
+**스킬 끝**

package/skills/index.json

@@ -0,0 +1,14 @@
+{
+  "version": "1.0.0",
+  "skills": [
+    {
+      "id": "VRIP_INSTALL_MANIFEST_DOCTOR",
+      "file": "VRIP_INSTALL_MANIFEST_DOCTOR.skill.md",
+      "version": "1.0.0",
+      "description": "MCP↔CLI↔Daemon 설치/실행 상태 진단 및 Gate 판정",
+      "tags": ["doctor", "manifest", "vrip", "diagnostic"],
+      "sha256": "ce45856decad28008792d124bc2d19a6d0db8dc327d2fc982e816954d92b2ea0"
+    }
+  ],
+  "created_at": "2026-01-24T12:00:00.000Z"
+}