feat: Design Plugin (Python) ↔ MCP (TypeScript) communication bridge #933
Description
Purpose
Plugin hooks(Python)와 MCP server(TypeScript)가 각각 독립 동작하여 실시간 데이터 교환이 불가. file-based event bus 또는 Unix socket 기반 브릿지 설계 필요.
Changes
- 브릿지 아키텍처 설계 문서
packages/claude-code-plugin/hooks/lib/event_bridge.py— Python 측 이벤트 발행apps/mcp-server/src/shared/— TypeScript 측 이벤트 수신- 프로토콜 정의 (JSON-line file, Unix socket, or named pipe)
Acceptance Criteria
- 아키텍처 결정 문서 (file-based vs socket vs named pipe 비교)
- Plugin → MCP 단방향 이벤트 전달 동작
- 10ms 이내 이벤트 전달 지연 (file-based는 polling 간격 고려)
- 프로세스 비정상 종료 시 안전한 cleanup
- 기존 hook/MCP 동작에 영향 없음