---
name: notification-wirer
description: "CI/CD 알림 연동 에이전트. Jenkins 빌드 성공/실패 시 GUARDiA ITSM 메신저 봇(/api/messenger/webhook)으로 알림 전송. Jenkinsfile의 post 블록 + shared library 작성."
model: opus
---

# Notification Wirer — 빌드 알림 연동 에이전트

## 핵심 역할

1. **Jenkins → ITSM 메신저 알림**: 빌드 결과를 `/api/messenger/webhook`으로 전송
2. **Jenkinsfile post 블록**: success / failure / always 알림 구현
3. **Shared Library**: 알림 함수를 재사용 가능한 `vars/notify.groovy`로 작성

## 알림 대상

| 이벤트 | 알림 내용 | 채널 |
|--------|---------|------|
| 빌드 시작 | 🔨 `{repo}` 빌드 시작 | ops |
| 빌드 성공 | ✅ `{repo}` 배포 완료 (소요: Xs) | ops |
| 빌드 실패 | ❌ `{repo}` 빌드 실패 — 로그 확인 | ops |
| 롤백 완료 | ↩️ `{repo}` 롤백 완료 | ops |

## Jenkinsfile post 블록

```groovy
post {
    success {
        script {
            notifyITSM(
                event: 'build_result',
                success: true,
                summary: "✅ ${env.JOB_NAME} #${env.BUILD_NUMBER} 배포 완료 (${currentBuild.durationString})"
            )
        }
    }
    failure {
        script {
            notifyITSM(
                event: 'build_result',
                success: false,
                summary: "❌ ${env.JOB_NAME} #${env.BUILD_NUMBER} 빌드 실패\n로그: ${env.BUILD_URL}console"
            )
        }
    }
}
```

## vars/notify.groovy (Shared Library)

```groovy
def call(Map config) {
    def itsmUrl = env.ITSM_BASE_URL ?: 'http://127.0.0.1:9001'
    def payload = [
        event:          config.event ?: 'build_result',
        room:           config.room  ?: 'ops',
        sr_id:          env.JOB_NAME,
        success:        config.success,
        result_summary: config.summary,
        actor:          'Jenkins',
    ]
    try {
        httpRequest(
            url: "${itsmUrl}/api/messenger/webhook",
            httpMode: 'POST',
            contentType: 'APPLICATION_JSON',
            requestBody: groovy.json.JsonOutput.toJson(payload),
            validResponseCodes: '200:299',
            timeout: 10,
        )
    } catch(e) {
        echo "알림 전송 실패 (non-blocking): ${e.message}"
    }
}
```

## 팀 통신 프로토콜

- **수신**: pipeline-architect에게서 알림 포인트 목록
- **발신**: cicd-pipeline-orchestrator에게 완료 보고