release(v4.8.0): bump framework and eight skills to 4.8.0 in lockstep; archive PR #41 reviews (three rounds)

Issue #33 (job budget, wall_clock_timeout vs deadline_timeout) and
Issue #30 (notify-only stall watcher). Reviews of PR #41 in the merge
workspace: round 1 (@1673818) claude N1 / codex R1 R2 NOT PASS, agy grok
PASS; round 2 (@af0a2a2) grok N1 / codex D1 D2 NOT PASS, claude agy PASS;
round 3 (@9200562) 4/4 PASS. Reports and the round-3 identity sidecars go
to .agents/reports/<session>/. The design consensus on items A-D is in the
VERSIONS.md entry.

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

VERSIONS.md

@@ -6,8 +6,8 @@
 
 ## 📌 현재 버전 개요 (Current Release)
 
-- **프레임워크 버전**: `v4.7.4`
-- **최신 릴리스 일시**: 2026-09-25 (KST)
+- **프레임워크 버전**: `v4.8.0`
+- **최신 릴리스 일시**: 2026-09-26 (KST)
 - **기준 브랜치**: `main`
 - **핵심 아키텍처**:
   - **Terminal 상태 단방향 불변성 (`engine.py`, Issue #6 Phase 1)**: `completed`, `error`, `cancelled` 터미널 상태 진입 후 후속 이벤트나 업데이트에 의한 덮어쓰기를 엄격히 차단(Terminal Immutability). `registry.py close` 서브커맨드 및 fail-closed 조기 종료 도입.
@@ -16,29 +16,53 @@
   - **결정론적 종료 코드 계약 (Issue #6 Phase 4 & R1)**: `0` (Success), `1` (Failure / Inject error), `2` (Subscriber timeout; 단, 에이전트가 Herdr에서 working 중이면 벽시계 --timeout까지 디스크 재관측 후 fail-close), `3` (Broker unavailable), `5` (Precondition failed / session_busy) 표준화. (send_keys_safe 헬퍼의 배달 실패/busy 타임아웃 rc=4는 래퍼 차원에서 rc=1 실패로 수용).
   - **프로토콜 기반 생존·전달 계약 (Issue #18)**: heartbeat 의무(N, 자동 타이머) · 무응답 판정(K×N) · 전달 확인(T 내 `started`) · retained `<prefix>/state` · 원격 전송(`remote:<name>`). TUI 스크래핑은 주입·다이얼로그·진단에만 남는다.
   - **워크트리 운영 모델 2단계 (Issue #21 항목 4·5·7)**: 워크트리 준비·해체 헬퍼(변경 전 판정, untracked 포함, 검증된 단일 `--force`), 리뷰 identity(라운드별 스냅샷·stale 재리뷰·승격 직전 재확인·`identity.json`), 수용 사례 A1–A8.
+  - **잡 예산·라벨·멈춤 알림 (Issue #33·#30)**: 위임 잡 예산은 `--job-timeout`/`MAM_JOB_TIMEOUT_S`, 벽시계 초과는 `wall_clock_timeout`(무응답 `deadline_timeout` 과 구분), `lib_py/stall_watch.py` 가 `blocked`/`idle` 을 `progress stalled:*` 로 알리기만 한다(종결 근거는 #18 의 프로토콜 이벤트뿐).
   - **4-Way 버전 락스텝**: `lib.sh`(`MAM_VERSION`) ↔ `lib_py/loop/eager.py`(`FRAMEWORK_VERSION`) ↔ `VERSIONS.md` ↔ 8개 `SKILL.md`.
 
 ---
 
 ## 🧭 스킬 패키지 버전 매트릭스 (Skills Version Matrix)
 
-모든 8개 스킬은 YAML frontmatter 메타데이터(`author`, `version`, `platforms`, `environments`) 표준화를 통해 `v4.7.4`로 동기화되어 배포됩니다.
+모든 8개 스킬은 YAML frontmatter 메타데이터(`author`, `version`, `platforms`, `environments`) 표준화를 통해 `v4.8.0`로 동기화되어 배포됩니다.
 
 | 스킬명 | 버전 | 역할 및 주요 책임 | 상태 |
 | :--- | :---: | :--- | :---: |
-| **`multi-agent-mux-create`** | `4.7.4` | 에이전트 세션 신규 생성 및 Herdr 컨테이너 격리 스폰 | ✅ 배포 |
-| **`multi-agent-mux-stop`** | `4.7.4` | 대화 UUID 원자적 캡처 및 세션 안전 종료 (Graceful Stop) | ✅ 배포 |
-| **`multi-agent-mux-resume`** | `4.7.4` | 온디스크 대화 컨텍스트 기반 Tier-1 초고속 세션 복원 | ✅ 배포 |
-| **`multi-agent-mux-status`** | `4.7.4` | 실시간 Herdr 세션 및 레지스트리 드리프트 스냅샷 조회 | ✅ 배포 |
-| **`multi-agent-mux-monitor`** | `4.7.4` | YAML ↔ 런타임 상태 간 자율 조정자 (Reconciler Loop) | ✅ 배포 |
-| **`multi-agent-mux-delegate-job`** | `4.7.4` | MQTT 이벤트 채널 기반 비동기 단위 작업 위임 | ✅ 배포 |
-| **`multi-agent-mux-loop`** | `4.7.4` | Planner-Creator-Reviewer 3자 자율 계획·실행·피어리뷰 루프 | ✅ 배포 |
-| **`multi-agent-mux-orc-onboard`** | `4.7.4` | 오케스트레이터 UUID 격리 등록 및 서브 세션 오염 방지 | ✅ 배포 |
+| **`multi-agent-mux-create`** | `4.8.0` | 에이전트 세션 신규 생성 및 Herdr 컨테이너 격리 스폰 | ✅ 배포 |
+| **`multi-agent-mux-stop`** | `4.8.0` | 대화 UUID 원자적 캡처 및 세션 안전 종료 (Graceful Stop) | ✅ 배포 |
+| **`multi-agent-mux-resume`** | `4.8.0` | 온디스크 대화 컨텍스트 기반 Tier-1 초고속 세션 복원 | ✅ 배포 |
+| **`multi-agent-mux-status`** | `4.8.0` | 실시간 Herdr 세션 및 레지스트리 드리프트 스냅샷 조회 | ✅ 배포 |
+| **`multi-agent-mux-monitor`** | `4.8.0` | YAML ↔ 런타임 상태 간 자율 조정자 (Reconciler Loop) | ✅ 배포 |
+| **`multi-agent-mux-delegate-job`** | `4.8.0` | MQTT 이벤트 채널 기반 비동기 단위 작업 위임 | ✅ 배포 |
+| **`multi-agent-mux-loop`** | `4.8.0` | Planner-Creator-Reviewer 3자 자율 계획·실행·피어리뷰 루프 | ✅ 배포 |
+| **`multi-agent-mux-orc-onboard`** | `4.8.0` | 오케스트레이터 UUID 격리 등록 및 서브 세션 오염 방지 | ✅ 배포 |
 
 ---
 
 ## 📋 버전별 상세 변경 내역 (Changelog)
 
+### 🚀 `v4.8.0` — Issue #33 위임 잡 예산 조절과 벽시계 라벨 분리, Issue #30 멈춘 에이전트 알림(알림 전용) (2026-09-26, PR #41)
+
+> **마이너 마일스톤 (MINOR Release)**: 위임 잡의 벽시계 예산(기본 3600 초)을 조절할 수 없고 벽시계 초과와 무응답이 같은 `deadline_timeout` 으로 기록되던 문제(Issue #33)와, 살아 있지만 멈춘 에이전트(권한 확인 창에 막힘, 종결 이벤트 없이 턴 종료)를 잡 제한 시간이 지나야만 알 수 있던 문제(Issue #30)를 한 브랜치로 고쳤다. 새 모듈 `lib_py/stall_watch.py`, 루프 옵션 `--job-timeout`, 새 종결 사유 `wall_clock_timeout`, 구독자 종료 코드 4 가 추가되어 MINOR 로 올린다. 예산 **연장**은 범위에서 빼고 #39(에이전트가 프로토콜 이벤트로 요청)로 분리했다.
+
+#### 🌟 주요 개선 사항
+1. **잡 예산이 이동한다 (#33, delegate-job 래퍼, `lib_py/loop/runner.py`, `remote.py`)**: 래퍼의 예산은 `--timeout` > `MAM_JOB_TIMEOUT_S` > 3600. 루프는 `--job-timeout <sec>` 을 받아 모든 위임 잡에 넘긴다. 러너의 잡 대기 상한과 #34 하위 잡 대기(`MAM_CHILD_WAIT_S`) 기본값은 상수 3900 이 아니라 **잡 예산 + 300 초**로 계산한다(명시값은 존중). 예산은 잡 하나 단위다. 원격 잡을 포함한 모든 transport 에 적용.
+2. **두 시계가 다른 라벨을 받는다 (#33, `job_subscriber.py`, 래퍼, `registry.py`, `engine.py`)**: 구독자는 원래 두 시계를 따로 셌지만 둘 다 rc 2 를 돌려줘 래퍼가 모두 `deadline_timeout` 으로 기록했다. 이제 벽시계 초과는 rc 4 → `wall_clock_timeout`, 무응답(K×N 초 이벤트 없음)은 rc 2 → `deadline_timeout`. 종료 코드는 구독자와 래퍼 양쪽에서 이름 붙은 상수(`RC_*` / `SUB_RC_*`)로 참조하고 두 쪽 값의 일치를 테스트로 고정. 디스크 heartbeat 유예가 deadline 에 닿아 끝나는 경우도 벽시계(`FINALIZE_CLOCK`). 등록부의 `close --request` 종류와 #34 하위 잡 표의 `CLOSED-UNCONFIRMED` 분류에 새 라벨 반영. `delegate-job wait` 는 두 시계 모두 기존대로 rc 2(하위 호환).
+3. **멈춤 감시자 — 알림 전용 (#30, `lib_py/stall_watch.py`)**: 래퍼 옆에서 잡의 에이전트 pane 을 herdr `agent wait` 로 지켜본다. **잡을 닫는 코드 경로가 없다** — 유일한 발행은 `progress` 이벤트(`_notify`)와 재주입 한 번이며 테스트로 고정. `blocked` → `progress --detail stalled:blocked` + herdr detection 화면의 문구 첨부, **자동 응답 없음**(#30 의 동기 사례가 "Dangerous rm operation… proceed?" 창). `idle` 이 `MAM_STALL_IDLE_S`(기본 600 초) 이어지고 에이전트에게 백그라운드 자식 프로세스가 없고 입력창이 비어 있으면 → `stalled:idle` + "이어서 하라" 신호 한 번(잡당 1회). 백그라운드 자식은 herdr 로 얻은 에이전트 pid 의 OS 자손으로 판정하고(Claude Code 는 백그라운드 명령을 별도 프로세스 그룹으로 띄워 herdr 에는 보이지 않는다), 상주 자식(codex 의 `codex-code-mode-host` 등)은 어댑터 필드(`resident_children`)로 제외. `agent_status` 신뢰도도 어댑터 필드. 원격·human 잡은 감시하지 않고 로그 한 줄. herdr 실패는 `MAM_STALL_HERDR_FAIL_S`(120 초) 뒤 경고. `MAM_STALL_WATCH=0` 으로 끔.
+4. **어댑터·입력창 (`lib_py/agents/*`, `input_region.py`)**: 상주 자식 목록과 `agent_status` 신뢰도 필드, 입력창이 비었는지 판정(여러 줄 초안, 프롬프트 글리프가 초안 안에 있는 경우). pane 픽스처 5종.
+5. **문서**: delegate-job/loop SKILL.md 에 `--job-timeout`, `MAM_JOB_TIMEOUT_S`, `wall_clock_timeout`, 감시자 환경변수 행.
+
+#### 🧭 설계 결정 (이슈 댓글의 계획에서 달라진 점)
+- 예산 연장(벽시계에 닿으면 멈춰서 묻고 정책이 연장)은 뺐다: 루프 러너가 래퍼를 동기 호출해 결정을 쓸 위치에 없고, 연장 거부 근거로 제안된 `state_change_seq` 정체는 한 시간 넘게 같은 상태로 전체 스위트를 도는 정상 creator 도 거부한다. #39 는 에이전트가 스스로 연장을 요청하는 방식을 다룬다.
+- 멈춤 판정은 알림 전용(#30 댓글 수정본, 2026-09-25): 재주입 실패 후 `stalled` 종결과 다이얼로그 자동 수락은 철회.
+- #17 항목 4(래퍼 종결 처리의 Python 이전)는 하지 않았다. bash 변경은 라벨을 나르는 부분으로 최소화. 리뷰어 합의(A–D, claude·agy·grok·codex): A 알림 전용 4/4 동의. B #39 분리 동의 — 연장 횟수·누적 예산 상한은 오케스트레이터 쪽, token/attempt 로 인증된 요청만 멱등 처리해 새 절대 deadline 확정, heartbeat 만 있고 `state_change_seq` 가 그대로면 거절, 원격 잡도 같은 규칙. C #40 트리거는 `completed` 를 검증하는 수신 측 — 래퍼 구독자가 기본 진입점, 루프 `wait_for_job` 은 누락 복구 경로(job/token/attempt 단위 중복 방지), #17 항목 4 에 흡수하거나 바로 다음. D 항목 4 를 미룬 것 동의 — 옮길 bash 판정: `FINALIZE_CLOCK`·디스크 유예 종료 결정, 감시 여부 판정, `MAM_JOB_TIMEOUT_S` 검증, rc→close_req/라벨 매핑, `_map_sub_rc`·`cmd_wait` 정규화, 감시자 수명 관리.
+
+#### ✅ 품질 검증
+- **신규 테스트** (`tests/test_issue30_stall_watch.py` 789줄, `tests/test_issue33_budget.py` 358줄): 예산 우선순위·전달·대기 상한, 두 시계의 라벨과 rc 상수 일치, 감시자의 판정(`judge`)·발행이 `progress` 뿐임·백그라운드 자식·입력창·재주입 1회·원격 제외·herdr 실패. 기존 테스트 조정: `test_tier1_unit.py` G-8(두 시계를 같은 값으로 주면 벽시계가 먼저 닿아 새 코드를 받던 결정적 회귀 → 값 분리), registry CLI 스냅샷·help 캡처, `test_issue18_*`, `conftest.py`.
+- **실제 에이전트 시험 (작성 워크스페이스, claude, `MAM_STALL_IDLE_S=45`)**: A. `started` 만 보내고 완료 없이 턴을 끝낸 에이전트 → 48 초 뒤 `stalled:idle` 경고와 신호 한 번, 에이전트가 받자마자 `completed`. B. 150 초 명령을 백그라운드로 돌리며 쉬는 에이전트 → 경고도 신호도 없이 명령이 끝난 뒤 스스로 `completed`. `blocked` 는 테스트로만 확인.
+- **리뷰**: 작성 워크스페이스 claude·agy·grok·codex 전원 PASS(opencode 는 Ollama 한도로 첫 회차 PASS 뒤 탈락). 병합 워크스페이스에서 PR head 를 detached 워크트리에 받아 재검토: 1회차(@1673818) claude NOT PASS(N1: 래퍼가 감시자를 무한 wait), codex NOT PASS(R1: 래퍼가 TERM 으로 죽으면 감시자 고아, R2: herdr 대기 중 닫힌 잡에 재주입), agy·grok PASS → af0a2a2 에서 유계 stop·`--watch-pid`·`_dispatch_open` 재검사. 2회차(델타) claude·agy PASS, grok NOT PASS(TERM 5 초 예산이 close 시계를 늦춤), codex NOT PASS(D1: 알림 발행 중 닫힌·재디스패치된 잡에 재주입, D2: 대기 중 래퍼 소멸 뒤 1회 재주입) → 9200562 에서 KILL 즉시 정지·prompt 직전 strict 게이트(`_may_prompt`)·wait 직후 래퍼 확인. 3회차(델타 @9200562) 4/4 PASS. 회귀 테스트 `tests/test_issue30_stall_watch_stop.py` 11건은 모두 수정 전 코드에서 hang/실패. 2회차 첫 실행은 claude 세션 사용량 한도로 끊겨 그 잡을 `cancelled` 로 닫고 다시 돌렸다. 리포트와 identity 사이드카는 `.agents/reports/<session>/`.
+- **전체 스위트 (병합 워크스페이스, 자체 venv 가 있는 워크트리)**: af0a2a2 전체 1230 passed / 4 failed / 5 skipped(73 분) — 실패 3건은 단독 재실행 통과, 1건은 B3(공개 브로커 heartbeat 지연, 1회차 head 에서도 같음). 최종 head 9200562 영향 파일(stall_watch_stop·stall_watch·issue14·issue33·tier1·version) 159 passed / 1 failed(B3) / 1 skipped(S6, Linux /proc).
+- **후속**: #17 항목 4 목록(합의 D), #39 연장 보완책(합의 B), #40 트리거(합의 C); `MAM_TEST_UNRELIABLE_AGENT` 테스트 훅(M7); B3·S9·S10·issue14 idle-grace·issue18:497 의 공개 브로커 의존(로컬 events.log 로 단언하거나 등록부터 브로커 격리); `MAM_JOB_TIMEOUT_S=08` 이 bash 에서 8진수로 읽힘; `MAM_WAIT_GRACE_S` 미문서·러너의 잘못된 `MAM_JOB_TIMEOUT_S` 무언; SKILL.md 의 ≤60 s 문구를 herdr wait 로 한정; 부모 소멸 테스트의 alive 대역을 wait 안에서 바꾸기.
+
 ### 🚀 `v4.7.4` — Issue #34 루프가 creator 의 하위 위임 잡까지 기다리고 리뷰어에게 하위 잡 상태를 근거로 제공 (2026-09-25, PR #38)
 
 > **패치 마일스톤 (PATCH Release)**: creator 가 작업 일부를 delegate-job 으로 다른 에이전트에게 맡기면, 그 하위 잡이 아직 돌고 있어도 루프가 리뷰로 넘어가 **미완성 산출물이 PASS** 되던 문제(Issue #34)를 고쳤다. 루프는 자신이 만든 잡만 감시했고 잡 레코드에는 부모·자식 관계가 없었다. 필드 하나(`parent_job`)와 옵션 둘(`--parent-job`, `--wait-open-jobs`)이 늘지만 잘못된 판정 경로를 고치는 수정이라 PATCH 로 올린다.