delegate-job

~/.hermes/skills/autonomous-ai-agents/delegate-job/
├── SKILL.md              # Claude 에이전트가 해석하는 프롬프트 가이드 지침
├── USER_MANUAL.html      # 사용자 분석용 HTML 지침서 (본 문서)
├── README.md             # 간략한 프로젝트 정보
├── job-protocol.md       # MQTT JSON 페이로드 규격 및 스키마 명세
├── registry.md           # 레지스트리 레코드의 속성 값 정의 및 락 매커니즘
├── mqtt-broker-setup.html # PoC → TLS 운영 브로커 컷오버 가이드 (HTML)
├── delegate-job          # 오케스트레이션 역할을 하는 Bash wrapper script
└── scripts/
    ├── mqtt_common.py    # 브로커 연결 빌드, 파일 락, 감사 로그 공통 모듈
    ├── registry.py       # Job 등록/수정을 관장하는 CLI 헬퍼 라이브러리
    ├── publish_event.py  # 구동 중인 에이전트가 이벤트를 쏠 때 쓰는 송신기
    └── job_subscriber.py # 위임 작업 종료 시점까지 백그라운드에서 감시하는 수신기

python/mqtt/jobs/<job_id>/events

{
  "schema_version": 1,
  "seq": 7,                              // 동일 JID 내 단조 증가하는 정수형 카운터
  "job_id": "abc12345",
  "event": "started",                    // started | permission_required | progress | completed | error
  "timestamp": "2026-06-19T09:32:00Z",   // ISO-8601 UTC 규격 시각
  "detail": "데이터베이스 쿼리 아티팩트 보관 완료",
  "data": {                              // 확장 요구사항 반영을 위한 옵션 메타 딕셔너리
    "auth_token": "a1b2c3d4..." 
  }
}

# 1) human 에이전트 용 임시 smoke 작업 생성
JID=$(.venv/bin/python skills/delegate-job/scripts/registry.py \
        --registry-dir .hermes/jobs register \
        --prompt "smoke: flatten+resplit" --agent human --agent-session tmux:flatten-smoke \
        --timeout 60 --idle-timeout 30 | tail -1)

# 2) 백그라운드 이벤트 감시 모니터 기동
.venv/bin/python skills/delegate-job/scripts/job_subscriber.py \
  --registry-dir .hermes/jobs --job "$JID" --timeout 60 --idle-timeout 30 &

# 3)started 라이프사이클 이벤트 강제 발행
.venv/bin/python skills/delegate-job/scripts/publish_event.py \
  --registry-dir .hermes/jobs --job "$JID" --event started \
  --detail "flatten smoke started"

# 4) completed 종단 이벤트 강제 발행
.venv/bin/python skills/delegate-job/scripts/publish_event.py \
  --registry-dir .hermes/jobs --job "$JID" --event completed \
  --detail "flatten smoke done"

# 5) 모니터 프로세스가 completed 접수 후 자동으로 자원 회수 종료 확인
wait %1

{"event": "registered", "status": "pending", "agent": "human", "agent_session": "tmux:flatten-smoke", "topic_prefix": "python/mqtt/jobs/cb32569f", "timestamp": "2026-06-19T04:09:50Z", "logged_at": "2026-06-19T04:09:50.846Z"}
{"event": "received", "source_event": "started", "seq": 1, "topic": "python/mqtt/jobs/cb32569f/events", "timestamp": "2026-06-19T04:10:03Z", "detail": "flatten smoke started", "logged_at": "2026-06-19T04:10:11.548Z"}
{"event": "published", "source_event": "started", "seq": 1, "topic": "python/mqtt/jobs/cb32569f/events", "retain": false, "timestamp": "2026-06-19T04:10:03Z", "detail": "flatten smoke started", "payload": {"schema_version": 1, "seq": 1, "job_id": "cb32569f", "event": "started", "timestamp": "2026-06-19T04:10:03Z", "detail": "flatten smoke started", "data": {}}, "logged_at": "2026-06-19T04:10:12.555Z"}
{"event": "status_changed", "from": "pending", "to": "running", "timestamp": "2026-06-19T04:10:12Z", "logged_at": "2026-06-19T04:10:12.558Z"}
{"event": "received", "source_event": "completed", "seq": 2, "topic": "python/mqtt/jobs/cb32569f/events", "timestamp": "2026-06-19T04:10:13Z", "detail": "flatten smoke done", "logged_at": "2026-06-19T04:10:16.927Z"}
{"event": "published", "source_event": "completed", "seq": 2, "topic": "python/mqtt/jobs/cb32569f/events", "retain": true, "timestamp": "2026-06-19T04:10:13Z", "detail": "flatten smoke done", "payload": {"schema_version": 1, "seq": 2, "job_id": "cb32569f", "event": "completed", "timestamp": "2026-06-19T04:10:13Z", "detail": "flatten smoke done", "data": {}}, "logged_at": "2026-06-19T04:10:17.932Z"}
{"event": "status_changed", "from": "running", "to": "completed", "timestamp": "2026-06-19T04:10:17Z", "logged_at": "2026-06-19T04:10:17.935Z"}

{
  "job_id": "cb32569f",
  "status": "completed",
  "updated_at": "2026-06-19T04:10:17Z"
}

export MQTT_BROKER=mqtt.internal.example.com
export MQTT_PORT=8883
export MQTT_TLS=1
export MQTT_CA_CERTS=/etc/ssl/certs/internal-ca.pem
export MQTT_USERNAME=hermes-operator
export MQTT_PASSWORD=secure_token_key

# 환경 주입
source mqtt.env

# 위임 submit 스크립트 재시동 (스크립트 소스코드 수정 무)
delegate-job submit --agent claude-code --prompt "운영 서버 이관 점검"