release(v4.6.0): bump framework and eight skills to 4.6.0 in lockstep; archive PR #22 merge-side reviews

Issue #21 phase-1 prerequisites (PR #22) add loop runner options and the
control-plane module: MINOR. VERSIONS.md gains the v4.6.0 entry, the
archived design reviews lose their markdown trailing whitespace so
`git diff --check` is clean, and the three merge-side PASS reports
(claude, agy, codex @ 4a81d15) are archived under .agents/reports/.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VCgu9Fa9iT7TbJUSzdq4Ff

VERSIONS.md

@@ -6,7 +6,7 @@
 
 ## 📌 현재 버전 개요 (Current Release)
 
-- **프레임워크 버전**: `v4.5.0`
+- **프레임워크 버전**: `v4.6.0`
 - **최신 릴리스 일시**: 2026-09-13 (KST)
 - **기준 브랜치**: `main`
 - **핵심 아키텍처**:
@@ -21,23 +21,38 @@
 
 ## 🧭 스킬 패키지 버전 매트릭스 (Skills Version Matrix)
 
-모든 8개 스킬은 YAML frontmatter 메타데이터(`author`, `version`, `platforms`, `environments`) 표준화를 통해 `v4.5.0`로 동기화되어 배포됩니다.
+모든 8개 스킬은 YAML frontmatter 메타데이터(`author`, `version`, `platforms`, `environments`) 표준화를 통해 `v4.6.0`로 동기화되어 배포됩니다.
 
 | 스킬명 | 버전 | 역할 및 주요 책임 | 상태 |
 | :--- | :---: | :--- | :---: |
-| **`multi-agent-mux-create`** | `4.5.0` | 에이전트 세션 신규 생성 및 Herdr 컨테이너 격리 스폰 | ✅ 배포 |
-| **`multi-agent-mux-stop`** | `4.5.0` | 대화 UUID 원자적 캡처 및 세션 안전 종료 (Graceful Stop) | ✅ 배포 |
-| **`multi-agent-mux-resume`** | `4.5.0` | 온디스크 대화 컨텍스트 기반 Tier-1 초고속 세션 복원 | ✅ 배포 |
-| **`multi-agent-mux-status`** | `4.5.0` | 실시간 Herdr 세션 및 레지스트리 드리프트 스냅샷 조회 | ✅ 배포 |
-| **`multi-agent-mux-monitor`** | `4.5.0` | YAML ↔ 런타임 상태 간 자율 조정자 (Reconciler Loop) | ✅ 배포 |
-| **`multi-agent-mux-delegate-job`** | `4.5.0` | MQTT 이벤트 채널 기반 비동기 단위 작업 위임 | ✅ 배포 |
-| **`multi-agent-mux-loop`** | `4.5.0` | Planner-Creator-Reviewer 3자 자율 계획·실행·피어리뷰 루프 | ✅ 배포 |
-| **`multi-agent-mux-orc-onboard`** | `4.5.0` | 오케스트레이터 UUID 격리 등록 및 서브 세션 오염 방지 | ✅ 배포 |
+| **`multi-agent-mux-create`** | `4.6.0` | 에이전트 세션 신규 생성 및 Herdr 컨테이너 격리 스폰 | ✅ 배포 |
+| **`multi-agent-mux-stop`** | `4.6.0` | 대화 UUID 원자적 캡처 및 세션 안전 종료 (Graceful Stop) | ✅ 배포 |
+| **`multi-agent-mux-resume`** | `4.6.0` | 온디스크 대화 컨텍스트 기반 Tier-1 초고속 세션 복원 | ✅ 배포 |
+| **`multi-agent-mux-status`** | `4.6.0` | 실시간 Herdr 세션 및 레지스트리 드리프트 스냅샷 조회 | ✅ 배포 |
+| **`multi-agent-mux-monitor`** | `4.6.0` | YAML ↔ 런타임 상태 간 자율 조정자 (Reconciler Loop) | ✅ 배포 |
+| **`multi-agent-mux-delegate-job`** | `4.6.0` | MQTT 이벤트 채널 기반 비동기 단위 작업 위임 | ✅ 배포 |
+| **`multi-agent-mux-loop`** | `4.6.0` | Planner-Creator-Reviewer 3자 자율 계획·실행·피어리뷰 루프 | ✅ 배포 |
+| **`multi-agent-mux-orc-onboard`** | `4.6.0` | 오케스트레이터 UUID 격리 등록 및 서브 세션 오염 방지 | ✅ 배포 |
 
 ---
 
 ## 📋 버전별 상세 변경 내역 (Changelog)
 
+### 🚀 `v4.6.0` — Issue #21 워크트리 운영 모델 1단계 선행 작업: 래퍼 절대경로, 루프 `--worktree`, 제어 평면 바인딩, 설계 문서 (2026-09-14, PR #22)
+
+> **마이너 마일스톤 (MINOR Release)**: "워크스페이스 = 체크아웃 경로" 가정을 느슨하게 하는 1단계다. creator 는 이슈별 git 워크트리에서, 리뷰어 풀은 본 체크아웃에서, 잡 브리프·레지스트리·리포트·체크포인트(제어 평면)는 본 체크아웃 하나에 두는 운영 모델(#21, `docs/design/worktree-creator-model.md`)의 선행 조건 4건(작업 항목 1·2·3·6)을 구현했다. 루프 러너 옵션 3개와 `lib_py/control_plane.py` 가 추가되어 MINOR 로 올린다. 옵션 없이 쓰면 종전 동작과 프롬프트가 바이트 단위로 같다. 항목 4(워크트리 준비/종료 헬퍼)·5(리뷰 identity)·7(시험 운영)·8(다중 루프)은 #21 에 남아 있다.
+
+#### 🌟 주요 개선 사항
+1. **래퍼 절대경로화 (`multi-agent-mux-delegate-job`)**: 주입 문구의 brief 경로, 시작/성공/오류 명령의 `--registry-dir`, 감사 로그 루트(`DELEGATE_JOB_LOGS_DIR`), 브리프의 Output Report Path 가 `$REGISTRY_DIR` 기준 절대경로가 됐다(`_abs_registry_dir`·`_pub_cmd`·`_instructions`, `printf %q` 인용). 워크트리 cwd 의 creator 가 `started` 를 발행하고 리포트를 본 체크아웃의 잡 디렉터리에 쓴다.
+2. **루프 러너 `--worktree <path>` / `--base <ref>` / `--review-only` (`lib_py/loop/runner.py`, `run_loop.sh`)**: diff 수집·`base_commit`·head 는 워크트리 기준, wrapper·레지스트리(`MAM_JOBS_DIR` 존중)·체크포인트·리포트 승격은 본 체크아웃 기준. 워크트리는 같은 저장소의 top-level 이어야 하고 `--base` 는 head 의 조상이어야 한다. 위임 프롬프트 앞에 `[워크트리 컨텍스트]`(소스 경로·브랜치·base·head·커밋 수·미커밋 여부·제어 평면) 블록을 붙인다. 변경 집합이 비면 fail-closed. `MAM_LOOP_WORKTREE` env 동치.
+3. **제어 평면 바인딩 (`lib_py/control_plane.py`, create/resume/stop/status/reconcile)**: `WORKSPACE_ROOT`/`AGENT_SESSIONS_YAML`/`MAM_JOBS_DIR`/`DELEGATE_JOB_LOGS_DIR` 4개 경로를 세션 행의 `control_plane` 필드로 영속화하고, `--workspace` 만으로 유도되는 기본값과 다를 때만 pane 생성 호출의 `--env` 로 전파한다(재사용 idle pane 에는 env 를 에이전트 인자로 넘기지 않으므로 env 가 필요하면 pane 을 새로 만든다 — h25 계약 갱신). 상대 `MAM_JOBS_DIR` 은 jobs dir 하나로 정규화, stop 은 감사 로그 루트를 유지, status/reconcile 은 `MAM_JOBS_DIR` 을 존중한다. 경로에 공백이 있으면 전파를 거부(rc 3)한다.
+4. **설계 문서 정정 (`docs/design/worktree-creator-model.md`)**: 4인 리뷰(#21 댓글, `docs/design/reviews/`)를 반영해 "현재 코드 기준" 을 부분 지원 + 필요한 수정으로, 1단계 리뷰 전용 흐름, 스킬별 호환성 표, 루트 3종(제어/소스/런타임)과 리뷰 identity 를 명시했다.
+
+#### ✅ 품질 검증
+- **신규 테스트**: `tests/test_issue21_worktree_prereqs.py`(래퍼 절대경로·러너 옵션·워크트리 검증·제어 평면 바인딩·전파·호환성), `tests/test_herdr_shim_contract.py` h25 갱신, T2-8 샌드박스화.
+- **리뷰**: 작성 워크스페이스 루프에서 claude·agy·grok PASS @13259ed, codex PASS @4a81d15; 병합 워크스페이스에서 PR head 를 detached 워크트리에 받아 claude·agy·codex 재검토 PASS @4a81d15(리포트 `.agents/reports/`). 병합 워크스페이스 전체 스위트 @4a81d15: 940 통과, 실패 1건은 부하 시 경계값에 걸리는 시간 판정(단독 재실행 통과).
+- **후속(비차단, #21·#20)**: create/resume 의 `mam_control_plane_json … || true` 가 실패를 삼킴 → 경고/exit 2; resume 의 "herdr 이미 살아 있음" 경로가 `CONTROL_PLANE_JSON` 미전달; T2-6 의 `os.environ` 직접 변경; issue14 `_job_for_inprocess_publish` 가 ambient `WORKSPACE_ROOT` 로 실제 감사 로그에 기록; acceptance5 가 공용 브로커에서 동시 실행 시 같은 세션 이름의 러너가 서로의 dispatch 를 소비(세션 이름 uuid4 화 필요); create 레시피에 `MAM_NO_SUBSCRIBER_DAEMON=1`.
+
 ### 🚀 `v4.5.0` — Issue #18 생존·전달 판정을 프로토콜 계약으로 완결: heartbeat 자동화, K×N 무응답, T 내 `started`, retained 상태, 원격 전송 (2026-09-13)
 
 > **마이너 마일스톤 (MINOR Release)**: 에이전트의 생존·전달 판정을 TUI 스크래핑(herdr `agent_status`, pane 문자열, 화면 변화)에서 떼어내어, 에이전트가 스스로 발행하는 이벤트(`started`/`progress`/`completed`/`error`)에 **의무·주기·타임아웃 규칙이 있는 계약**을 부여했다(Issue #18, #17 항목 1). 새 이벤트 종류는 없다. 원격 호스트의 에이전트(pane·디스크 공유 없음)를 같은 계약으로 다루는 `remote:` 전송을 추가했다. 래퍼 옵션 3개(`--heartbeat`, `--heartbeat-misses`, `--ack-timeout`)와 `publish_event --heartbeat`, `job_subscriber --remote`, `remote.py` CLI 가 추가되어 MINOR 로 올린다. 기본값(N=30, K=4 → idle 120 s, T=180)은 종전 idle 기본값과 같으므로 기존 호출은 동작이 유지된다.