fix(deploy): migrate deployment scripts and docs from tmux to herdr

.agents/reports/canary-projects-multi-agent-mux-reviewer-cline/report-94ce2fcc.md

@@ -0,0 +1,46 @@
+# ✅ deploy/ 배포 설정 tmux→herdr 전환 수정 완료 보고
+
+**Job ID**: 94ce2fcc (동일 작업: 60af70e4)
+**Role**: Implementation (Cline)
+**Plan**: [report-baa15c96.md](.agents/reports/canary-projects-multi-agent-mux-planner-reviewer-claude/report-baa15c96.md)
+**Brief**: [.mam/deploy_patch_brief.md](.mam/deploy_patch_brief.md)
+
+## 적용된 변경 (5 파일, 7 에디트)
+
+### 1. deploy/install_mam.sh (기능 파손 수정 — 우선순위 1)
+- **L224**: `--tmux-server multi-agent-mux` → `--herdr-server multi-agent-mux`
+  - 근거: `create_session.sh:63`의 실제 플래그(`--herdr-server`) — 기존 `--tmux-server`는 create_session.sh가 거부(unknown arg, exit 2)하여 복붙 시 즉시 실패하는 기능 파손
+- **L227**: `tmux -L multi-agent-mux attach -t <session_name>` → `HERDR_SERVER_NAME=multi-agent-mux herdr agent attach <session_name>`
+  - 근거: `create_session.sh:328`이 YAML `attach_command`로 방출하는 canonical 형식과 1:1 일치 (`HERDR_SERVER_NAME={server} herdr agent attach {name}`)
+
+### 2. deploy/install.sh
+- **L31**: `check_cmd tmux` → `check_cmd herdr` (올바른 의존성 진단)
+- **L249**: `TMUX_SERVER_NAME=default` → `HERDR_SERVER_NAME=default` (소비처 0인 죽은 설정 → 실제 소비 변수)
+
+### 3. deploy/README.md
+- **L9**: `checks system requirements (\`tmux\`, \`python3\`)` → `\`herdr\`, \`python3\``
+
+### 4. deploy/INSTALL.md
+- **L21**: 진단 목록 `tmux` → `herdr`
+- **L37**: 의존성 진단 `tmux` → `herdr`
+- **L69**: `tmux가 소멸한 경우` → `herdr 서버가 소멸한 경우`
+
+### 5. deploy/plugin.json
+- **L3**: `Backplane on Tmux & MQTT.` → `Backplane on Herdr & MQTT.`
+
+## 검증 결과 (DoD)
+
+1. ✅ **잔존 스윕**: `grep -rin tmux deploy/` → **0건** (대소문자 무시)
+2. ✅ **정적**: `bash -n` install_mam.sh/install.sh 모두 exit 0; `shellcheck -S warning` exit 0 (신규 경고 0건); `python3 -m json.tool plugin.json` VALID
+3. ✅ **기능**: `--herdr-server`가 `create_session.sh:35/63`의 실제 플래그 확인; attach 형식이 `create_session.sh:328` canonical 형식과 1:1 일치
+4. ✅ **회귀**: `env -u HERDR_SERVER_NAME pytest tests/test_tier1_unit.py tests/test_tier2_component.py` → **55 passed**
+
+## 계획서 교정사항 반영
+- ~~`HERDR_SESSION_NAME`~~ → **`HERDR_SERVER_NAME`** (스킬 전체가 소비하는 유일한 변수명) ✅
+- ~~`--herdr-session`~~ → **`--herdr-server`** (create_session.sh:63 of 유일한 플래그) ✅
+
+## 제외 항목 (계획서 §1-6)
+- remove.sh / update.sh: tmux/kill 로직 없음 → 수정 불요 ✅
+- generate-env.sh / gitea-ci.yml: tmux 참조 없음 → 수정 불요 ✅
+
+[VERDICT: PASS]

.agents/skills/lib.sh

@@ -1576,7 +1576,7 @@ send_keys_safe() {
     _sks_herdr send-keys -t "$sess" C-m
     return 0
   fi
-  sleep 0.5
+  sleep "${SKS_PASTE_SLEEP:-1.5}"
   local pane_content was_popup=0
   pane_content=$(_pane_capture "$sess")
   if printf '%s\n' "$pane_content" | grep -Eq "Pasted text|paste again to expand"; then

.agents/skills/multi-agent-mux-delegate-job/multi-agent-mux-delegate-job

@@ -138,6 +138,19 @@ cmd_submit() {
 - **Timeout**: $TIMEOUT s (Idle: $IDLE_TIMEOUT s)
 - **Output Report Path**: .mam/jobs/$JOB_ID/$AGENT-reports/report-final.md
 
+## 🔔 Execution Commands
+On start run:
+python3 .agents/skills/multi-agent-mux-delegate-job/scripts/publish_event.py --registry-dir .mam/jobs --job $JOB_ID --event started
+
+On progress (optional):
+python3 .agents/skills/multi-agent-mux-delegate-job/scripts/publish_event.py --registry-dir .mam/jobs --job $JOB_ID --event progress --detail '<short status>'
+
+On success run:
+python3 .agents/skills/multi-agent-mux-delegate-job/scripts/publish_event.py --registry-dir .mam/jobs --job $JOB_ID --event completed --detail '<one-line summary>'
+
+On failure run:
+python3 .agents/skills/multi-agent-mux-delegate-job/scripts/publish_event.py --registry-dir .mam/jobs --job $JOB_ID --event error --detail '<one-line reason>'
+
 ## 🔎 Task Description
 $PROMPT
 EOF
@@ -184,7 +197,8 @@ EOF
     # an id from an earlier session is the #1 reason a delegated job sits idle and
     # times out (see SKILL.md "Wrong job_id propagated to the agent"). We make the
     # freshness explicit in the instruction header.
-    local instructions="Your job_id is \"$JOB_ID\". Detailed task requirements, instructions, and target output paths are documented in the task brief file at: .mam/jobs/$JOB_ID/brief.md. Please READ and follow .mam/jobs/$JOB_ID/brief.md to complete your work. Commands: start='$pub --event started', success='$pub --event completed --detail <summary>', error='$pub --event error --detail <reason>'."
+    # Keep this short and ASCII-only to prevent paste/wrap rendering issues in CLI REPLs.
+    local instructions="Job $JOB_ID: Read .mam/jobs/$JOB_ID/brief.md and complete the task."
 
     run_agent "$JOB_ID" "$instructions"
 

deploy/INSTALL.md

@@ -18,7 +18,7 @@ MAM 스킬 및 스크립트들은 호스트 시스템의 다음 도구들에 의
 
 ## 2. 🚀 자동 설치 방법
 
-MAM의 자동 설치 스크립트(`deploy/install_mam.sh`)를 사용하여 10초 만에 필요한 규칙과 라이프사이클 툴킷을 타겟 프로젝트에 이식할 수 있습니다. 스크립트는 실행 시 자동으로 시스템의 `tmux`, `python3`, `rsync`, `uuidgen` 및 필수 파이썬 모듈들을 진단합니다.
+MAM의 자동 설치 스크립트(`deploy/install_mam.sh`)를 사용하여 10초 만에 필요한 규칙과 라이프사이클 툴킷을 타겟 프로젝트에 이식할 수 있습니다. 스크립트는 실행 시 자동으로 시스템의 `herdr`, `python3`, `rsync`, `uuidgen` 및 필수 파이썬 모듈들을 진단합니다.
 
 > [!IMPORTANT]
 > **설치 전제조건**: MAM 스킬을 타겟 프로젝트에 설치하려면 **먼저 MAM 레포지토리가 로컬 머신에 clone 되어 있어야 합니다.**
@@ -34,7 +34,7 @@ $ bash deploy/install_mam.sh --target /path/to/your/project --force
 ```
 
 ### 설치 스크립트가 수행하는 작업:
-1.  **의존성 진단**: 시스템에 `tmux`, `python3`, `rsync`, `uuidgen` CLI 바이너리와 파이썬 `pyyaml`/`sqlite3` 모듈이 설치되어 있는지 확인합니다.
+1.  **의존성 진단**: 시스템에 `herdr`, `python3`, `rsync`, `uuidgen` CLI 바이너리와 파이썬 `pyyaml`/`sqlite3` 모듈이 설치되어 있는지 확인합니다.
 2.  **규칙 및 스킬 복제**: 오케스트레이션 가이드(`.agents/` 하위 전체)를 타겟 프로젝트 하위로 이식합니다.
 3.  **지침 전파**: 에이전트가 로드하고 복종할 행동 지침 문서(`AGENTS.md`)를 프로젝트 루트에 복사합니다.
 4.  **형상 제외 설정**: 세션 DB 및 격리 캐시 저장소인 `.mam/` 디렉토리를 타겟 프로젝트의 `.gitignore` 에 자동 주입하여 불필요한 형상 관리를 방지합니다.
@@ -66,7 +66,7 @@ $ herdr session attach my-project-dev-claude
 *   **화면 탈출**: 대화 중 세션을 유지한 채 터미널로 돌아오려면 `Ctrl + B`를 누른 뒤 `D` 키를 차례로 입력합니다.
 
 ### 3) 에이전트 상태 복원 (Resume)
-세션이 중지되었거나, 호스트 재기동으로 tmux가 소멸한 경우에도 이전 대화 ID 및 격리 디렉토리를 원자적으로 이어받아 다시 기동할 수 있습니다.
+세션이 중지되었거나, 호스트 재기동으로 herdr 서버가 소멸한 경우에도 이전 대화 ID 및 격리 디렉토리를 원자적으로 이어받아 다시 기동할 수 있습니다.
 ```bash
 # 1단계: 복원 대상 세션의 UUID 자동 조회 (DB/YAML 레지스트리 기반)
 $ WORKSPACE="/path/to/your/project"

deploy/README.md

@@ -6,7 +6,7 @@ This directory contains packaging templates and installation scripts to deploy t
 
 ## 📁 Deployment Directory Structure
 
-*   **`install.sh`**: A self-contained, idempotent remote shell installer (via curl) that checks system requirements (`tmux`, `python3`), detects NFS/network filesystem mounts, sets up a local python virtual environment (`.venv`), and initializes environment configuration (`.env`).
+*   **`install.sh`**: A self-contained, idempotent remote shell installer (via curl) that checks system requirements (`herdr`, `python3`), detects NFS/network filesystem mounts, sets up a local python virtual environment (`.venv`), and initializes environment configuration (`.env`).
 *   **`install_mam.sh`**: A local-clone installer that copies rules/skills (`.agents/`), `AGENTS.md`, and sets up environment bootstrap on target projects.
 *   **`generate-env.sh`**: Environment configuration bootstrap helper.
 *   **`INSTALL.md`**: Detailed installation and quick-start user manual.

deploy/install.sh

@@ -28,7 +28,7 @@ check_cmd() {
   fi
 }
 
-check_cmd tmux
+check_cmd herdr
 check_cmd python3
 
 # Verify Python Version
@@ -246,7 +246,7 @@ MQTT_BROKER=broker.hivemq.com
 MQTT_PORT=1883
 MQTT_TLS=0
 MQTT_CLIENT_ID_PREFIX=mam-agent
-TMUX_SERVER_NAME=default
+HERDR_SERVER_NAME=default
 EOF
   chmod 0600 "$ENV_FILE"
   echo "✅ Config file .env initialized with chmod 0600."

deploy/install_mam.sh

@@ -221,10 +221,10 @@ cat <<EOF
   1. Initialize a new isolated session:
      $ bash .agents/skills/multi-agent-mux-create/scripts/create_session.sh \\
          --workspace "$TARGET_DIR" --agent claude --role developer --isolate \\
-         --tmux-server multi-agent-mux
+         --herdr-server multi-agent-mux
 
   2. Attach to the running session:
-     $ tmux -L multi-agent-mux attach -t <session_name>
+     $ HERDR_SERVER_NAME=multi-agent-mux herdr agent attach <session_name>
 
   3. Gracefully stop the session:
      $ bash .agents/skills/multi-agent-mux-stop/scripts/stop_session.sh \\

deploy/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "multi-agent-mux",
-  "description": "Multi-Agent Orchestration & Messaging Backplane on Tmux & MQTT.",
+  "description": "Multi-Agent Orchestration & Messaging Backplane on Herdr & MQTT.",
   "disabled": false
 }