Migrate backend to herdr using a seamless translation shim wrapper

deploy/INSTALL.md

@@ -8,7 +8,7 @@ MAM은 단일 워크스페이스 상에서 복수의 에이전트(Claude, Cline,
 
 ## 1. ⚙️ 사전 요구사항
 MAM 스킬 및 스크립트들은 호스트 시스템의 다음 도구들에 의존합니다. 설치 전에 확인해 주세요.
-*   **tmux**: 에이전트를 백그라운드 격리 Pane에서 구동하기 위한 프로세스 컨테이너
+*   **herdr**: 에이전트를 백그라운드 격리 Pane/Workspace에서 구동 및 관제하기 위한 프로세스 컨테이너
 *   **python3**: 세션 레지스트리(YAML/SQLite DB) 파싱 및 유효성 검사 (내장 `sqlite3` 모듈 필수)
 *   **uuidgen**: 격리 세션 생성 시 고유의 UUID 할당
 *   **rsync**: 인스톨러(`deploy/install_mam.sh`)가 `.agents/` 오케스트레이터 및 스킬 폴더를 타겟 프로젝트에 복제하는 데 사용 (설치 시 필요)
@@ -54,14 +54,14 @@ $ bash .agents/skills/multi-agent-mux-create/scripts/create_session.sh \
     --role developer \
     --session my-project-dev-claude \
     --isolate \
-    --tmux-server multi-agent-mux
+    --herdr-workspace multi-agent-mux
 ```
 *   `--isolate` 옵션을 주면 `.mam/agent_homes/<uuid>/` 하위에 로그인 및 설정은 유지하되 대화 내역은 격리되는 홈이 형성됩니다.
 
 ### 2) 세션 접속 (Attach)
-백그라운드에서 구동된 에이전트 TUI 화면에 들어갑니다. (세션 생성 시 지정한 독립 격리 tmux 서버 소켓 `-L multi-agent-mux` 를 경유해 접속합니다.)
+백그라운드에서 구동된 에이전트 TUI 화면에 들어갑니다.
 ```bash
-$ tmux -L multi-agent-mux attach -t my-project-dev-claude
+$ herdr session attach my-project-dev-claude
 ```
 *   **화면 탈출**: 대화 중 세션을 유지한 채 터미널로 돌아오려면 `Ctrl + B`를 누른 뒤 `D` 키를 차례로 입력합니다.
 
@@ -81,8 +81,8 @@ $ [ -n "$UUID" ] || { echo "[ERROR] 매칭되는 활성 세션 이력이 없습
  
 # 2단계: 세션 재기동 (이전 대화 컨텍스트 복원 기동)
 # (주의: 만약 create 시 격리(--isolate) 세션으로 생성했다면, CLAUDE_CONFIG_DIR 환경변수를 YAML에 기록된 isolation.root 경로로 지정하여 띄워야 합니다. 상세 격리 복원 커맨드는 .agents/skills/multi-agent-mux-resume/SKILL.md 문서를 필독해 주세요.)
-$ tmux -L multi-agent-mux new-session -d -s "$SESSION_NAME" -x 140 -y 40 -c "$WORKSPACE" \
-    "claude --dangerously-skip-permissions -r $UUID; echo 'CLAUDE EXIT'; bash"
+$ herdr run -d --name "$SESSION_NAME" --workspace "$WORKSPACE" -- \
+    "claude --dangerously-skip-permissions -r $UUID"
  
 # 3단계: 레지스트리 세션 상태를 running 으로 동기화 갱신
 $ bash .agents/skills/multi-agent-mux-resume/scripts/update_yaml_resumed.sh \

deploy/install_mam.sh

@@ -83,7 +83,7 @@ fi
 
 # 1. Dependency Checks
 log_info "Verifying host dependencies..."
-DEPS=(tmux python3 rsync uuidgen)
+DEPS=(herdr python3 rsync uuidgen)
 MISSING_DEPS=()
 for dep in "${DEPS[@]}"; do
   if ! command -v "$dep" &>/dev/null; then
@@ -93,6 +93,10 @@ done
 
 if [ ${#MISSING_DEPS[@]} -ne 0 ]; then
   log_error "Missing required dependencies: ${MISSING_DEPS[*]}"
+  if [[ " ${MISSING_DEPS[*]} " == *" herdr "* ]]; then
+    log_error "To install herdr, please refer to the official installation guide:"
+    log_error "  curl -fsSL https://herdr.dev/install.sh | sh"
+  fi
   log_error "Please install them before using MAM."
   exit 1
 fi