mandu-mcp-deploy

Mandu MCP Deploy

프로덕션 배포 직전의 fail-fast 파이프라인. 개별 검증 도구를 손으로 나열하는 대신, mandu.deploy.check 와 mandu.deploy.preview 집계 도구를 쓴다.

Trigger

• "배포", "release", "deploy"
• release tag 직전, git push origin main 직전
• 프로덕션 환경 업로드 전
• CI/CD 에서 deploy job 이전
• mandu-deploy task-shaped skill 이 활성화될 때

Recipe (순서 고정, 게이트 엄격)

mandu_build                     ← 프로덕션 빌드 시작
  └─> mandu_build_status        ← green 대기 (polling)
       └─> mandu.deploy.check   ← Tier-0 aggregate: guard+contract+manifest 병렬
            │                      ─ fail → 즉시 중단, deploy_preview 금지
            └─> mandu_write_seo_file  ← sitemap/robots/meta 확정
                 └─> mandu.deploy.preview ← 프로덕션 리허설 (Tier-0)
                      └─> 사용자에게 배포 승인 요청
                           └─> (사용자 승인) 외부 배포 실행

Step Detail

Step 1 — mandu_build

mandu_build({ profile: "production" })

alias of mandu.build. 프로덕션 번들 생성. 반환에 jobId / status 포함. 이 호출은 비동기일 수 있다 — 즉시 반환 후 Step 2 로 poll.

Step 2 — mandu_build_status (poll until green)

mandu_build_status({ jobId })

alias of mandu.build.status. status ∈ {pending, running, success, failed}.

• success → Step 3
• failed → 중단, 빌드 에러 분석 후 mandu-mcp-verify 로 이동
• running → 짧은 간격으로 재호출

CRITICAL: 빌드 failed 이면 mandu.deploy.check 절대 호출하지 않는다. 빌드가 깨진 상태에서 deploy check 를 돌리면 잘못된 positive/negative 가 나온다.

Step 3 — mandu.deploy.check (Fail-Fast Gate)

mandu.deploy.check({ target: "bun" })

반환:

• ok: true → Step 4 로 진행
• ok: false, blockers: [...] → 즉시 중단

blockers 예시:

• guard 위반 (레이어, 금지 import)
• contract validation 실패
• manifest 깨짐 (route 누락 / 중복)

각 blocker 는 가리키는 도구가 있다:

• guard → mandu_guard_explain, mandu_guard_heal (단, safe-change 감싸기)
• contract → mandu_validate_contracts, mandu_create_contract
• manifest → mandu_validate_manifest

blocker 를 고치면 Step 1 부터 재실행. deploy_preview 로 건너뛰지 않는다.

Step 4 — mandu_write_seo_file

mandu_write_seo_file({ target: "sitemap" })
mandu_write_seo_file({ target: "robots" })
mandu_write_seo_file({ target: "meta" })