feat(mcp): Phase 1 — tool spec + src/mcp skeleton (Refs #292)

[erishforG]

무엇

v1.0 MCP 서버의 첫 번째 Phase: tool catalogue spec 문서 + src/mcp/ 모듈 skeleton.

변경 내용

• docs/mcp/spec.md: 10개 MCP 도구의 완전한 JSON Schema 설계 문서
  • worktree_list, worktree_start, worktree_status, worktree_ship
  • smartlog, ci_status, pr_status, health_check, reviews, sync
  • 각 도구별 inputSchema (JSON Schema draft-07), response shape, error codes
  • 설계 원칙 (worktree-native, dry_run first-class, PAT delegation, CLI surface 불변)
• src/mcp/mod.rs: McpContext, ToolDef, TOOLS 상수 registry
• src/mcp/tools/: 7개 stub 모듈 (worktree, smartlog, ci, pr, health, reviews, sync)
• 5개 unit test: registry 유효성, snake_case+unique, 설명 비어있지 않음, McpContext 생성

왜

Refs #292 (v1.0 MCP tool spec), Refs #241 (MCP server meta-issue)

v1.0 MCP 서버 구현의 가장 중요한 사전 작업: Phase 2 (stdio JSON-RPC) 시작 전에 어떤 도구를 어떤 스키마로 노출할지 확정 필요. 이 스펙 문서가 Phase 2~6의 설계 기준점 역할을 함.

변경 파일 요약

파일	타입
docs/mcp/spec.md	신규 — 설계 문서
src/mcp/mod.rs	신규 — McpContext + TOOLS registry
src/mcp/tools/*.rs	신규 — Phase 1 stubs (9개 파일)
src/main.rs	수정 — mod mcp; 추가 (알파벳 순 위치)

다음 Phase 힌트

• Phase 2 (feat(mcp): stdio transport + Claude Desktop/Cursor 등록 가이드 #293): parsec mcp serve 서브커맨드 추가 + stdio JSON-RPC echo 서버 (입력 파싱 → tools/list 응답)
• Phase 3 (feat(mcp): stdio transport + Claude Desktop/Cursor 등록 가이드 #293): worktree_list + worktree_status 실제 구현 연결
• Phase 4 (feat(mcp): stdio transport + Claude Desktop/Cursor 등록 가이드 #293): 나머지 8개 도구 구현 연결

리스크

• 없음 — 신규 모듈 전용, 기존 CLI/worktree/git2 코드 미수정
• #[allow(dead_code)] 은 src/mcp 모듈 전체에만 적용 (Phase 2에서 제거)

롤백

이 PR을 revert하면 src/mcp/ 디렉터리와 docs/mcp/ 가 완전히 제거되어 깔끔하게 롤백됨.

Test plan

cargo build --quiet        # ✅ clean
cargo fmt --check          # ✅ pass
cargo clippy --all-targets -- -D warnings  # ✅ clean
cargo test --quiet         # ✅ 71+5+67 = 143 tests pass (5개 신규 mcp:: tests 포함)

@erishforG 검토 부탁드립니다 🙏