fix(herdr): resolve shim routing defects, add workspace scoping, and bump to v3.0.1
- Resolve Herdr shim 5 routing & paste defects (ISSUE-1 ~ ISSUE-5):
* paste-buffer: use pane send-text without auto-enter, propagate rc=3 to send_keys_safe
* exact-match pane resolution: remove substring matching ('in tn') across all branches
* workspace scoping: introduce HERDR_WORKSPACE_ID and .mam/herdr_workspace_id persistence
* unified resolver: single _resolve_herdr_pane_id helper across shim commands
- Resolve dialog token false-positive on 'Yes, try it' tip and isolate fullscreen modal rejection
- Sync mock Herdr CLI contracts in tests/conftest.py
- Add contract tests H-15~H-23 and regression tests D-4~D-7 (412 tests, 100% PASS)
- Add multi-agent loop plans, review reports, and bug report
- Update framework and skill packages to v3.0.1
This commit is contained in:
@@ -0,0 +1,508 @@
|
||||
# 📐 구현 계획서: Herdr 셈(shim) 패인 라우팅 결함 4종 수정 (ISSUE-1/2/3/5)
|
||||
|
||||
- **Job ID**: `fae58b93`
|
||||
- **Role**: Planner (`planner-reviewer-claude-01`)
|
||||
- **작성일**: 2026-08-27
|
||||
- **대상**: `.agents/skills/lib.sh`, `tests/conftest.py`, `tests/test_herdr_shim_contract.py`, `tests/test_b19_headless_reconcile_fixes.py`
|
||||
- **근거 문서**: `bug_report.md` (v1.0)
|
||||
- **기준 커밋**: `4bbd03b` (main)
|
||||
|
||||
---
|
||||
|
||||
## 0. 요약 (TL;DR)
|
||||
|
||||
`bug_report.md`의 5대 결함 중 ISSUE-4는 이미 커밋 `4bbd03b`에서 해결되어 회귀 테스트(`test_agent_start_success_tokens_exclude_startup_timeout`)로 고정되어 있다. 남은 **ISSUE-1 / 2 / 3 / 5**를 다음 순서로 처리한다.
|
||||
|
||||
1. **ISSUE-5 선행** — 셈 내부에 공용 헬퍼 `_resolve_herdr_pane_id`를 신설한다. 나머지 3개 이슈의 수정이 전부 이 헬퍼 안으로 수렴하므로 이것이 반드시 먼저다.
|
||||
2. **ISSUE-2** — 헬퍼 및 `_resolve_herdr_target` / `has-session`에서 `agent in tn` 부분 매칭을 전면 제거하고 엄격 일치로 대체.
|
||||
3. **ISSUE-3** — `HERDR_WORKSPACE_ID`가 **명시적으로 설정된 경우에만** `pane list --workspace`로 하드 스코핑.
|
||||
4. **ISSUE-1** — `paste-buffer`를 `pane send-text` 단독 삽입으로 교체(엔터 금지), 해결 실패 시 조용히 삼키지 말고 실패를 상위로 전달.
|
||||
|
||||
---
|
||||
|
||||
## 1. 사전 조사에서 확인된 사실 (계획의 전제)
|
||||
|
||||
계획 수립 중 실제 `herdr` 바이너리(`/opt/homebrew/bin/herdr`)와 현재 `lib.sh`를 직접 검증했다. **버그 리포트의 권고 코드를 그대로 옮기면 안 되는 지점이 3곳** 있다.
|
||||
|
||||
### 1.1 ✅ `herdr agent send` 서브커맨드는 존재하지 않는다 (ISSUE-1의 진짜 뿌리)
|
||||
|
||||
```
|
||||
$ herdr agent --help
|
||||
Commands: list get read send-keys prompt rename focus wait attach start explain
|
||||
```
|
||||
|
||||
현재 `lib.sh:822`의 `paste-buffer` 구현은 다음 한 줄이 전부다.
|
||||
|
||||
```bash
|
||||
_real_herdr agent send "$sess" "$(cat "$buffer_dir/$buf")" >/dev/null 2>&1 || true
|
||||
```
|
||||
|
||||
`agent send`는 CLI에 없으므로 이 호출은 **항상 실패하고 `|| true`가 실패를 삼킨다**. 즉 현재 `main`에서 `paste-buffer` 경로는 텍스트를 단 한 글자도 주입하지 못하는 완전한 데드 코드다. 이것이 브리프의 "`paste-buffer`의 `herdr agent send` 부재"가 가리키는 실체이며, `send_keys_safe`의 폴백 경로 전체가 무력화되어 있음을 뜻한다.
|
||||
|
||||
> 참고: `send_keys_safe`는 `agent prompt` 고속 경로가 성공하면 즉시 반환하므로(`lib.sh:1785`), **등록된 agent에 대해서는** 이 결함이 드러나지 않는다. 결함이 표면화되는 조건은 정확히 버그 리포트가 기술한 상황 — `agent prompt`가 실패하는 **라벨 전용 패인(agent 미등록)** — 이다.
|
||||
|
||||
### 1.2 ⚠️ 버그 리포트의 `pane_id` 정규식은 실제 pane_id를 거부한다
|
||||
|
||||
버그 리포트 §3.1은 다음 검증을 제안한다.
|
||||
|
||||
```bash
|
||||
if [[ "$pid" =~ ^w[0-9]+:p[0-9]+$ ]]; then
|
||||
```
|
||||
|
||||
그러나 실제 서버가 반환하는 pane_id는 다음과 같다.
|
||||
|
||||
```json
|
||||
{"pane_id":"w1E:p1","workspace_id":"w1E","tab_id":"w1E:t1", ...}
|
||||
```
|
||||
|
||||
워크스페이스 세그먼트는 `w1E`처럼 **영문자를 포함**한다. 권고 정규식을 그대로 쓰면 모든 실제 pane_id가 거부되어 헬퍼가 항상 실패하고, 결과적으로 ISSUE-1을 고친 뒤에도 주입이 되지 않는다.
|
||||
|
||||
→ **채택 정규식**: `^w[A-Za-z0-9]+:p[A-Za-z0-9]+$`
|
||||
|
||||
### 1.3 ⚠️ 실제 `pane list` 응답에는 `label` 키가 없을 수 있다
|
||||
|
||||
```json
|
||||
{"agent":"claude","agent_status":"working","cwd":"...","pane_id":"w1E:p1",
|
||||
"tab_id":"w1E:t1","terminal_title":"...","workspace_id":"w1E"}
|
||||
```
|
||||
|
||||
`label`은 `herdr pane rename <PANE_ID> <LABEL>`로 설정했을 때만 나타난다. 반면 `agent list`에는 `name` 필드가 있다(`"name":"planner-reviewer-claude-01"`). 따라서 헬퍼의 매칭 우선순위는 `label` → `name` → `agent` 순으로 두되, **셋 다 완전 일치만** 허용한다. `agent` 필드는 사실상 CLI 종류(`claude`/`grok`)이므로 `tn`이 그 값과 완전히 같은 경우에만 매칭되며, 이는 부분 매칭과 달리 오라우팅을 만들지 않는다.
|
||||
|
||||
### 1.4 ✅ `pane list`는 서버측 `--workspace` 필터를 지원한다
|
||||
|
||||
```
|
||||
$ herdr pane list --help
|
||||
Options:
|
||||
--workspace <WORKSPACE_ID>
|
||||
```
|
||||
|
||||
ISSUE-3의 스코핑은 파이썬 클라이언트 필터링만이 아니라 **서버측 플래그로 1차 차단**할 수 있다. 양쪽 모두 적용한다(플래그 미지원 구버전 herdr 대비 이중 방어).
|
||||
|
||||
### 1.5 ✅ `pane read`와 `agent read`의 출력 형식은 호환된다
|
||||
|
||||
둘 다 평문 텍스트를 반환하며, `_pane_capture`(`lib.sh:1672`)는 JSON 파싱 실패 시 원문을 그대로 반환하므로 `capture-pane`을 `pane read`로 전환해도 상위 로직이 깨지지 않는다.
|
||||
|
||||
### 1.6 ⚠️ 셈은 `set -euo pipefail` 아래에서 실행된다
|
||||
|
||||
셈 본문은 `lib.sh:141`의 `cat <<'EOF'` ~ `lib.sh:959`의 `EOF` 사이 히어독으로 생성되며 3번째 줄이 `set -euo pipefail`이다. 따라서 실패를 반환할 수 있는 새 헬퍼는 **모든 호출부에서 `|| true`로 감싸야** 하며, 그렇지 않으면 셈이 조기 종료된다.
|
||||
|
||||
### 1.7 ✅ 테스트 목(mock)이 결함을 은폐하고 있다
|
||||
|
||||
`tests/conftest.py:638`의 목 herdr는 존재하지 않는 `agent send`를 **성공으로 처리**한다. 이 때문에 ISSUE-1이 테스트에서 전혀 드러나지 않았다. 목을 실제 CLI 계약에 맞추는 것이 이번 작업의 필수 선행 조건이다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 변경 대상 목록
|
||||
|
||||
| # | 파일 | 위치 | 이슈 | 성격 |
|
||||
|---|---|---|---|---|
|
||||
| C1 | `.agents/skills/lib.sh` | 셈 히어독, `_sanitize_herdr_agent_name` 직후 (~L236) | 5 | 신규 헬퍼 `_resolve_herdr_workspace_scope`, `_resolve_herdr_pane_id` |
|
||||
| C2 | `.agents/skills/lib.sh` | `_resolve_herdr_target` (L249–286) | 2,3 | 부분 매칭 제거 + ws 필터 |
|
||||
| C3 | `.agents/skills/lib.sh` | `has-session` (L305–345) | 2,3,5 | 부분 매칭 제거 + ws 필터 + 헬퍼 폴백 |
|
||||
| C4 | `.agents/skills/lib.sh` | `new-session` (L434–530) | 3 | 해결된 workspace_id를 `HERDR_WORKSPACE_ID`로 export |
|
||||
| C5 | `.agents/skills/lib.sh` | `kill-session` (L567–603) | 5 | 인라인 파서 → 헬퍼 |
|
||||
| C6 | `.agents/skills/lib.sh` | `capture-pane` (L687–704) | 3,5 | 헬퍼 + `pane read` 경로 |
|
||||
| C7 | `.agents/skills/lib.sh` | `send-keys` (L705–744) | 2,3,5 | 인라인 파서 → 헬퍼 |
|
||||
| C8 | `.agents/skills/lib.sh` | `paste-buffer` (L794–827) | 1,5 | `agent send` → `pane send-text`, 엔터 금지, 실패 전파 |
|
||||
| C9 | `.agents/skills/lib.sh` | `send_keys_safe` (L1804–1806) | 1 | `paste-buffer` 종료 코드 확인 → rc 3 |
|
||||
| C10 | `tests/conftest.py` | 목 herdr | 1,2,3 | `pane send-text`/`pane read`/`pane rename` 추가, `pane list` 병합·라벨·`--workspace`, `agent send` 제거 |
|
||||
| T1 | `tests/test_herdr_shim_contract.py` | 신규 | 1,2,3,5 | H-15 ~ H-20 |
|
||||
| T2 | `tests/test_b19_headless_reconcile_fixes.py` | 신규 | 1,2,5 | D-4 ~ D-7 |
|
||||
|
||||
> `list-panes`(L605–686)의 인라인 파서는 `pane_id` 외에 `cwd`/`agent`까지 한 번에 파싱하므로 헬퍼로 대체하지 **않는다**. ISSUE-5의 대상 목록에도 포함되어 있지 않다.
|
||||
|
||||
---
|
||||
|
||||
## 3. 상세 구현 설계
|
||||
|
||||
### 3.1 [C1] 공용 헬퍼 신설 (ISSUE-5)
|
||||
|
||||
`lib.sh` 셈 히어독 내부, `_sanitize_herdr_agent_name` 정의 직후(`cmd="${1:-}"` 앞)에 삽입한다. 이 위치여야 `case` 분기 전체에서 참조 가능하다.
|
||||
|
||||
```bash
|
||||
# ---------------------------------------------------------------------------
|
||||
# Workspace scoping (ISSUE-3).
|
||||
#
|
||||
# 스코핑은 HERDR_WORKSPACE_ID 가 "명시적으로" 설정된 경우에만 하드 필터로
|
||||
# 동작한다. cwd 로부터 자동 추론하지 않는다 — 자동 추론은 다중 워크스페이스
|
||||
# 오케스트레이션에서 정당한 교차 워크스페이스 조회를 조용히 막아버린다.
|
||||
# 미설정 시에는 서버 전역 조회(기존 동작)를 유지한다.
|
||||
# ---------------------------------------------------------------------------
|
||||
_herdr_ws_scope() { printf '%s\n' "${HERDR_WORKSPACE_ID:-}"; }
|
||||
|
||||
# _resolve_herdr_pane_id <target> [workspace_id]
|
||||
#
|
||||
# 세션 이름 / 라벨을 실제 pane_id ("wN:pM") 로 해석한다.
|
||||
# 엄격한 해석 순서 (부분 문자열 매칭은 어느 단계에서도 사용하지 않는다):
|
||||
# 1. herdr agent get <sanitized_name>
|
||||
# 2. herdr agent get <raw_name>
|
||||
# 3. herdr pane list [--workspace WS] 에서
|
||||
# 3-a. label 완전 일치
|
||||
# 3-b. name 완전 일치
|
||||
# 3-c. agent 완전 일치
|
||||
# 성공 시 pane_id 를 stdout 에 출력하고 0, 실패 시 아무것도 출력하지 않고 1.
|
||||
# 호출부는 반드시 `|| true` 로 감쌀 것 (셈은 set -e 하에서 동작한다).
|
||||
_resolve_herdr_pane_id() {
|
||||
local target="$1"
|
||||
local target_ws="${2:-$(_herdr_ws_scope)}"
|
||||
local sat pid=""
|
||||
sat=$(_sanitize_herdr_agent_name "$target")
|
||||
|
||||
local cand
|
||||
for cand in "$sat" "$target"; do
|
||||
[ -n "$cand" ] || continue
|
||||
pid=$(_real_herdr agent get "$cand" 2>/dev/null | TARGET_WS="$target_ws" python3 -c "
|
||||
import sys, json, os
|
||||
tws = os.environ.get('TARGET_WS', '')
|
||||
try:
|
||||
a = json.load(sys.stdin).get('result', {}).get('agent', {})
|
||||
# ISSUE-3: 워크스페이스가 지정되면 다른 워크스페이스의 동명 agent 는 거부.
|
||||
if tws and a.get('workspace_id') and a.get('workspace_id') != tws:
|
||||
pass
|
||||
else:
|
||||
print(a.get('pane_id') or '')
|
||||
except Exception:
|
||||
pass
|
||||
" 2>/dev/null || echo "")
|
||||
[ -n "$pid" ] && break
|
||||
done
|
||||
|
||||
if [ -z "$pid" ]; then
|
||||
local ws_flag=()
|
||||
[ -n "$target_ws" ] && ws_flag=(--workspace "$target_ws")
|
||||
pid=$(_real_herdr pane list "${ws_flag[@]+"${ws_flag[@]}"}" 2>/dev/null \
|
||||
| TARGET_NAME="$target" TARGET_SAN="$sat" TARGET_WS="$target_ws" python3 -c "
|
||||
import sys, json, os
|
||||
tn = os.environ.get('TARGET_NAME', '')
|
||||
tsa = os.environ.get('TARGET_SAN', '')
|
||||
tws = os.environ.get('TARGET_WS', '')
|
||||
try:
|
||||
panes = json.load(sys.stdin).get('result', {}).get('panes', [])
|
||||
# 서버가 --workspace 를 무시하는 구버전일 수 있으므로 클라이언트에서 한 번 더 거른다.
|
||||
if tws:
|
||||
panes = [p for p in panes if p.get('workspace_id') == tws]
|
||||
# ISSUE-2: 완전 일치만 허용. 'agent in tn' 부분 매칭은 사용하지 않는다.
|
||||
for key in ('label', 'name', 'agent'):
|
||||
for p in panes:
|
||||
v = p.get(key)
|
||||
if v and (v == tn or v == tsa):
|
||||
pid = p.get('pane_id') or ''
|
||||
if pid:
|
||||
print(pid)
|
||||
sys.exit(0)
|
||||
except Exception:
|
||||
pass
|
||||
sys.exit(1)
|
||||
" 2>/dev/null || echo "")
|
||||
fi
|
||||
|
||||
# 실제 pane_id 는 'w1E:p1' 처럼 워크스페이스 세그먼트에 영문자를 포함한다.
|
||||
# ^w[0-9]+:p[0-9]+$ 로 좁히면 모든 실제 pane_id 가 거부된다.
|
||||
if [[ "$pid" =~ ^w[A-Za-z0-9]+:p[A-Za-z0-9]+$ ]]; then
|
||||
printf '%s\n' "$pid"
|
||||
return 0
|
||||
fi
|
||||
return 1
|
||||
}
|
||||
```
|
||||
|
||||
**설계 근거**
|
||||
|
||||
- **`for key in ('label','name','agent')` 바깥 루프**: 우선순위가 "패인 목록의 등장 순서"가 아니라 "필드의 신뢰도"로 결정된다. 안쪽/바깥쪽 루프를 뒤집으면 목록 첫 항목의 `agent` 매칭이 뒤쪽 항목의 정확한 `label` 매칭을 이겨버린다 — 이것이 ISSUE-2가 만든 오라우팅과 동일한 형태의 버그다.
|
||||
- **`tsa`(sanitized) 도 비교 대상에 포함**: `agent start`가 이름을 sanitize해서 등록하므로, 라벨은 원본이고 등록명은 sanitize본인 혼재 상황을 커버한다. sanitize는 결정적 함수이므로 부분 매칭과 달리 충돌을 만들지 않는다.
|
||||
- **`ws_flag` 배열 + `${ws_flag[@]+...}`**: `set -u` 하에서 빈 배열 전개가 unbound 오류를 내지 않도록 하는 표준 관용구.
|
||||
|
||||
### 3.2 [C2] `_resolve_herdr_target` 엄격화 (ISSUE-2, ISSUE-3)
|
||||
|
||||
`lib.sh:262–275`의 파이썬 블록에서 다음 술어를 제거한다.
|
||||
|
||||
```python
|
||||
if name == tn or (not name and agent and agent in tn): # ← 제거
|
||||
```
|
||||
|
||||
교체:
|
||||
|
||||
```python
|
||||
tn = os.environ.get("TARGET_NAME", "")
|
||||
tsa = os.environ.get("TARGET_SAN", "")
|
||||
tws = os.environ.get("TARGET_WS", "")
|
||||
...
|
||||
agents = d.get("result", {}).get("agents", [])
|
||||
if tws:
|
||||
agents = [a for a in agents if a.get("workspace_id") == tws]
|
||||
for a in agents:
|
||||
name = a.get("name", "")
|
||||
if name and (name == tn or name == tsa):
|
||||
print(a.get("pane_id") or name)
|
||||
sys.exit(0)
|
||||
sys.exit(1)
|
||||
```
|
||||
|
||||
`pane_id or agent` → `pane_id or name`으로 바꾼다. 기존 코드는 매칭에 실패한 항목의 CLI 종류(`agent`, 예: `"claude"`)를 타깃으로 반환할 수 있었는데, 이는 `agent prompt claude ...`처럼 전혀 다른 대상에게 프롬프트를 던지는 경로다.
|
||||
|
||||
### 3.3 [C3] `has-session` 엄격화 + 패인 폴백 (ISSUE-2, ISSUE-3, ISSUE-5)
|
||||
|
||||
`lib.sh:334`의 다음 술어를 제거한다.
|
||||
|
||||
```python
|
||||
or (not an and a.get("agent") and a.get("agent") in tn) # ← 제거
|
||||
```
|
||||
|
||||
남는 조건은 `an == tn or an == stn`이며, 여기에 `HERDR_WORKSPACE_ID` 필터를 추가한다.
|
||||
|
||||
그리고 agent 조회가 모두 실패했을 때 마지막 단계로 헬퍼를 호출한다.
|
||||
|
||||
```bash
|
||||
if [ -n "$(_resolve_herdr_pane_id "$sess" 2>/dev/null || true)" ]; then
|
||||
exit 0
|
||||
fi
|
||||
exit 1
|
||||
```
|
||||
|
||||
**의도적 동작 변경**: 라벨만 붙은(agent 미등록) 패인도 이제 "세션 존재"로 판정된다. 이것이 정확히 버그 리포트가 보고한 실패 시나리오(`label: reviewer-cline-01` 패인에 주입 불가)의 해소 조건이다. `_resolve_herdr_pane_id`가 완전 일치만 허용하므로, 세션 이름 `reviewer-creator-grok-01`이 `agent == "grok"` 패인에 매칭될 일은 없다.
|
||||
|
||||
**리스크**: `create_session.sh` / `reconcile.sh`가 `has-session` 결과로 재생성 여부를 판단한다면, 라벨만 있고 실제 CLI가 죽은 패인을 "살아 있음"으로 오판할 수 있다. → 3.9의 회귀 검증 범위에 `test_orc_onboard.py`, `test_tier3_integration.py`, `test_tier4_e2e.py`를 명시적으로 포함한다.
|
||||
|
||||
### 3.4 [C4] `HERDR_WORKSPACE_ID` 전파 (ISSUE-3)
|
||||
|
||||
`new-session` 분기에서 `existing_ws` 또는 신규 `ws_id`가 확정된 직후(`lib.sh:509` 이후 `ws_id` 확정 지점) 다음을 추가한다.
|
||||
|
||||
```bash
|
||||
if [ -n "${ws_id:-}" ]; then
|
||||
export HERDR_WORKSPACE_ID="$ws_id"
|
||||
fi
|
||||
```
|
||||
|
||||
또한 `agent start`에 전달하는 `env_flags`에 `--env HERDR_WORKSPACE_ID=$ws_id`를 추가하여, 기동된 에이전트 프로세스가 상속한 셈 호출부터 자동으로 스코프가 걸리도록 한다.
|
||||
|
||||
**채택하지 않은 대안**: 셈이 `$PWD`/`$WORKSPACE_ROOT`의 cwd로부터 workspace_id를 자동 추론하는 방식. 추론이 성공하는 순간 교차 워크스페이스 조회가 **조용히** 막히고, 오케스트레이터가 다른 워크스페이스의 에이전트를 정당하게 다루는 경로가 원인 불명으로 깨진다. 스코핑은 명시적 옵트인이어야 진단 가능하다.
|
||||
|
||||
### 3.5 [C5]~[C7] 분기 리팩터링 (ISSUE-5)
|
||||
|
||||
**`kill-session`** — `lib.sh:587–598`의 이중 인라인 파이썬을 삭제.
|
||||
|
||||
```bash
|
||||
agent_target=$(_sanitize_herdr_agent_name "$sess")
|
||||
pane_id=$(_resolve_herdr_pane_id "$sess" 2>/dev/null || true)
|
||||
if [ -n "$pane_id" ]; then
|
||||
_real_herdr pane close "$pane_id" >/dev/null 2>&1 || true
|
||||
fi
|
||||
_real_herdr kill-session -t "$agent_target" >/dev/null 2>&1 \
|
||||
|| _real_herdr kill-session -t "$sess" >/dev/null 2>&1 || true
|
||||
```
|
||||
|
||||
**`capture-pane`** — 헬퍼로 pane_id를 얻으면 `pane read`, 아니면 기존 `agent read` 체인 유지.
|
||||
|
||||
```bash
|
||||
agent_target=$(_sanitize_herdr_agent_name "$sess")
|
||||
pane_id=$(_resolve_herdr_pane_id "$sess" 2>/dev/null || true)
|
||||
if [ -n "$pane_id" ]; then
|
||||
_real_herdr pane read "$pane_id" --source visible --lines 100 2>/dev/null || true
|
||||
else
|
||||
_real_herdr agent read "$agent_target" --source visible --lines 100 2>/dev/null \
|
||||
|| _real_herdr agent read "$sess" --source visible --lines 100 2>/dev/null || true
|
||||
fi
|
||||
```
|
||||
|
||||
**`send-keys`** — `lib.sh:726–738`의 이중 인라인 파이썬을 삭제하고 헬퍼 호출로 대체. 폴백(`pane send-keys "$agent_target"` → `"$sess"`)은 그대로 유지한다. `C-m` → `Enter` 정규화(L741–743)도 유지 — 이건 키 이름 번역이지 제출 정책이 아니다.
|
||||
|
||||
**ISSUE-5의 "데드 파이프라인" 부분**: 기존 인라인 파서는 `except: pass`로 항상 exit 0을 반환해 `||` 2차 폴백이 절대 실행되지 않았다. 신규 헬퍼는 `sys.exit(1)` + 정규식 검증 + `return 1`로 실패를 정확히 신호하므로 이 데드 코드가 구조적으로 제거된다.
|
||||
|
||||
### 3.6 [C8] `paste-buffer` 재작성 (ISSUE-1)
|
||||
|
||||
```bash
|
||||
buffer_dir="${WORKSPACE_ROOT:+$WORKSPACE_ROOT/.mam/buffers}"
|
||||
buffer_dir="${buffer_dir:-${TMPDIR:-/tmp}/mam_buffers}"
|
||||
if [ ! -f "$buffer_dir/$buf" ]; then
|
||||
echo "Error: buffer $buf not found ($buffer_dir/$buf)" >&2
|
||||
exit 1
|
||||
fi
|
||||
pane_id=$(_resolve_herdr_pane_id "$sess" 2>/dev/null || true)
|
||||
if [ -z "$pane_id" ]; then
|
||||
# herdr 에는 `agent send` 서브커맨드가 없다. 여기서 조용히 성공을 반환하면
|
||||
# send_keys_safe 가 아무것도 붙여넣지 않은 채 Enter 만 치게 된다.
|
||||
echo "Error: paste-buffer could not resolve a pane for '$sess'" >&2
|
||||
exit 1
|
||||
fi
|
||||
# 삽입 전용. Enter/C-m 제출은 전적으로 send_keys_safe 가 통제한다 (ISSUE-1).
|
||||
# 여기서 `pane run` 을 쓰면 안 된다 — 텍스트와 Enter 를 한 번에 보내 이중 제출이 된다.
|
||||
if ! _real_herdr pane send-text "$pane_id" "$(cat "$buffer_dir/$buf")" >/dev/null 2>&1; then
|
||||
echo "Error: pane send-text failed for '$sess' ($pane_id)" >&2
|
||||
exit 1
|
||||
fi
|
||||
```
|
||||
|
||||
**불변식 (테스트로 고정)**: `paste-buffer` 분기 본문에는 `Enter`, `C-m`, `pane run`, `agent prompt` 중 어떤 것도 등장하지 않는다.
|
||||
|
||||
### 3.7 [C9] `send_keys_safe`의 붙여넣기 실패 전파 (ISSUE-1)
|
||||
|
||||
현재 `lib.sh:1804–1806`은 `paste-buffer`의 종료 코드를 버린다. 그리고 세션 이름에 `cline|claude|agy|grok`이 포함되면 붙여넣기 가시성 검증마저 건너뛴다(L1809–1812) — 즉 **실제 운영 대상 전부**에서 실패가 무성으로 삼켜진다.
|
||||
|
||||
```bash
|
||||
_sks_herdr set-buffer -b "$sks_buf" "$text"
|
||||
local _paste_rc=0
|
||||
_sks_herdr paste-buffer -b "$sks_buf" -t "$sess" || _paste_rc=$?
|
||||
_sks_herdr delete-buffer -b "$sks_buf" 2>/dev/null || true
|
||||
if [ "$_paste_rc" != "0" ]; then
|
||||
echo "send_keys_safe: paste-buffer failed rc=$_paste_rc ($sess)" >&2
|
||||
return 3
|
||||
fi
|
||||
```
|
||||
|
||||
버퍼 정리(`delete-buffer`)는 조기 반환 **앞**에 둔다. 그렇지 않으면 실패 경로마다 버퍼가 누수되어 `set-buffer`의 A-3 GC 주석이 방어하는 바로 그 문제가 재발한다.
|
||||
|
||||
기존 반환 코드 계약(`3 = paste not visible`)을 재사용하므로 호출자 계약은 바뀌지 않는다.
|
||||
|
||||
### 3.8 [C10] 테스트 목(mock) 정합화 — `tests/conftest.py`
|
||||
|
||||
테스트 코드보다 **먼저** 처리해야 한다. 목이 실제 CLI와 어긋나 있는 한 어떤 테스트도 결함을 재현할 수 없다.
|
||||
|
||||
| 변경 | 위치 | 내용 |
|
||||
|---|---|---|
|
||||
| M1 | `cmd1 == "agent"`, `cmd2 == "send"` (L638–664) | **핸들러 삭제** → 실제 CLI처럼 unknown subcommand로 exit 1. ISSUE-1 재현의 필수 조건 |
|
||||
| M2 | `cmd1 == "pane"` | `send-text` 핸들러 추가: pane_id로 대상 조회, `sent_text` 누적, `buffer` 갱신, `sent_keys`는 **건드리지 않음** |
|
||||
| M3 | `cmd1 == "pane"` | `read` 핸들러 추가: 대상 패인의 `buffer` 평문 출력 |
|
||||
| M4 | `cmd1 == "pane"` | `rename` 핸들러 추가: `state["panes"]`의 해당 항목에 `label` 기록 |
|
||||
| M5 | `pane list` (L253–281) | 현재는 agents가 하나라도 있으면 `state["panes"]`를 **무시**한다. → agent 유래 패인과 `state["panes"]`를 `pane_id` 기준으로 병합(dedupe)하고, `label`/`name` 필드를 그대로 실어 보낸다. 라벨 전용 패인 시나리오가 이 변경 없이는 표현 불가 |
|
||||
| M6 | `pane list` | `--workspace` 필터는 이미 구현되어 있음(L255–261). 유지 |
|
||||
| M7 | `agent get` (L569) | 응답에 `workspace_id`가 이미 포함됨(L594). 유지 |
|
||||
|
||||
목의 `_match_agent`(L182)는 이미 엄격(완전 일치 / sanitize 일치)하므로 변경 불필요하다.
|
||||
|
||||
---
|
||||
|
||||
## 4. 테스트 계획
|
||||
|
||||
### 4.1 `tests/test_herdr_shim_contract.py` — 행위 테스트 (신규 H-15 ~ H-20)
|
||||
|
||||
기존 파일의 규약을 따른다: `mam_sandbox` / `mock_herdr` / `mock_agents` 픽스처로 셈을 실제 실행하고, `mock_herdr_state.json`의 `calls` 배열을 검증한다.
|
||||
|
||||
**H-15 `test_h15_paste_buffer_inserts_without_enter`** (ISSUE-1)
|
||||
- 준비: `mock_agents`로 `test-creator-claude` 기동.
|
||||
- 실행: `herdr set-buffer -b t1 "hello world"` → `herdr paste-buffer -b t1 -t test-creator-claude`.
|
||||
- 단언:
|
||||
- `calls`에 `["pane","send-text",<pane_id>,"hello world"]`가 정확히 1회.
|
||||
- `calls`에 `["agent","send",...]`가 **0회** (M1로 이제 실패하게 되므로 회귀 감지).
|
||||
- `paste-buffer` 실행으로 발생한 `calls` 중 `pane send-keys` / `agent prompt` / `pane run`이 **0회** ← 이중 제출 방지의 핵심 단언.
|
||||
|
||||
**H-16 `test_h16_send_keys_safe_submits_exactly_once`** (ISSUE-1 종단)
|
||||
- `agent prompt` 고속 경로를 강제로 실패시켜(존재하지 않는 세션명 또는 목의 `prompt` 실패 주입) 폴백 경로를 타게 한다.
|
||||
- 단언: `Enter`/`C-m` 키 전송 횟수 총합이 정확히 1. (현재 코드는 `paste-buffer` 자체가 죽어 0회, 버그 리포트가 기술한 패치 상태에서는 2회 — 양쪽 모두 이 테스트가 잡는다.)
|
||||
|
||||
**H-17 `test_h17_no_substring_cross_pane_routing`** (ISSUE-2) — **핵심 회귀 테스트**
|
||||
- 준비: `reviewer-creator-grok-01`, `worker-grok-02` 두 agent를 서로 다른 pane_id로 기동.
|
||||
- 실행: `herdr send-keys -t reviewer-creator-grok-01 C-m`.
|
||||
- 단언: `pane send-keys`의 대상 pane_id가 `reviewer-creator-grok-01`의 것과 일치. `worker-grok-02`의 pane_id로 간 호출은 0회.
|
||||
- 추가: agent 등록 없이 `agent: "grok"` 라벨 전용 패인만 두고 `herdr has-session -t reviewer-creator-grok-01` → **exit 1**이어야 한다(예전 부분 매칭이면 0).
|
||||
|
||||
**H-18 `test_h18_workspace_scoped_pane_resolution`** (ISSUE-3)
|
||||
- 준비: `state["panes"]`에 동일 `label: creator-agy-01`을 `workspace_id: w1`, `w2`에 각각 1개씩 시드.
|
||||
- 실행 A: `HERDR_WORKSPACE_ID=w2 herdr send-keys -t creator-agy-01 Enter` → 대상이 `w2`의 pane_id.
|
||||
- 실행 B: `HERDR_WORKSPACE_ID=w1` → 대상이 `w1`의 pane_id.
|
||||
- 실행 C: `HERDR_WORKSPACE_ID` 미설정 → 해석은 성공하되 실패하지 않음(기존 전역 동작 보존).
|
||||
|
||||
**H-19 `test_h19_single_resolver_helper_used_by_all_branches`** (ISSUE-5)
|
||||
- 생성된 셈 파일(`$WORKSPACE_ROOT/.mam/shim/herdr`)을 읽어:
|
||||
- `_resolve_herdr_pane_id()` 정의가 정확히 1회 등장.
|
||||
- `has-session` / `kill-session` / `capture-pane` / `send-keys` / `paste-buffer` 각 분기 본문에서 `_resolve_herdr_pane_id` 호출이 등장.
|
||||
- `result', {}).get('agent', {}).get('pane_id'` 형태의 인라인 파서 잔존 개수가 헬퍼 내부 1곳으로 한정.
|
||||
- `bash -n`으로 셈 구문 검증.
|
||||
|
||||
**H-20 `test_h20_pane_id_regex_accepts_alphanumeric_workspace`** (§1.2 회귀 방지)
|
||||
- 헬퍼를 직접 호출해 `w1E:p1`, `w10:p3` 형태가 통과하고 `notapane`, `w1:p`, 빈 문자열이 거부되는지 확인.
|
||||
- 이 테스트가 없으면 버그 리포트 원문의 `^w[0-9]+:p[0-9]+$`가 나중에 다시 들어와도 아무도 모른다.
|
||||
|
||||
### 4.2 `tests/test_b19_headless_reconcile_fixes.py` — 소스/헬퍼 단위 테스트 (신규 D-4 ~ D-7)
|
||||
|
||||
기존 `_run_lib_helpers()` 헬퍼(L119–130)와 소스 문자열 검사 패턴을 재사용한다.
|
||||
|
||||
**D-4 `test_resolve_pane_id_fails_cleanly_under_set_e`**
|
||||
- `set -euo pipefail` 아래에서 `_resolve_herdr_pane_id nonexistent || true`가 셸을 죽이지 않고 빈 출력 + rc 1을 내는지.
|
||||
|
||||
**D-5 `test_send_keys_safe_returns_3_when_paste_buffer_fails`** (ISSUE-1)
|
||||
- `_sks_herdr` 스텁: `agent prompt` → rc 1, `paste-buffer` → rc 1, `send-keys` 호출은 파일에 기록.
|
||||
- 단언: `send_keys_safe` rc == 3, 기록 파일에 `C-m` 없음.
|
||||
- 추가 단언: `delete-buffer`가 호출되었음(버퍼 누수 방지).
|
||||
|
||||
**D-6 `test_no_substring_matching_remains_in_lib_sh`** (ISSUE-2) — 소스 가드
|
||||
- `lib.sh` 전문에서 정규식 `\bin tn\b` 및 `agent"\) in tn` 패턴 매치가 0건.
|
||||
- `_resolve_herdr_pane_id` 본문에 `^w[A-Za-z0-9]+:p[A-Za-z0-9]+$`가 존재.
|
||||
|
||||
**D-7 `test_paste_buffer_branch_never_submits`** (ISSUE-1) — 소스 가드
|
||||
- `lib.sh`에서 `paste-buffer)` ~ 다음 `;;` 구간을 잘라내어 `Enter`, `C-m`, `pane run`, `agent prompt` 문자열이 없음을 단언.
|
||||
- 행위 테스트(H-15)와 중복처럼 보이지만 층이 다르다: H-15는 목 경유라 목이 잘못되면 함께 침묵하고, D-7은 소스를 직접 본다.
|
||||
|
||||
### 4.3 회귀 범위
|
||||
|
||||
`has-session` 의미 변경(3.3)과 `capture-pane` 경로 변경(3.5)이 넓게 파급되므로, 다음을 우선 확인한 뒤 전체를 돌린다.
|
||||
|
||||
```bash
|
||||
.venv/bin/python -m pytest tests/test_herdr_shim_contract.py \
|
||||
tests/test_b19_headless_reconcile_fixes.py \
|
||||
tests/test_b8_send_keys_verification.py \
|
||||
tests/test_orc_onboard.py tests/test_workspace_scope.py \
|
||||
tests/test_uuid_target.py tests/test_sanitize_and_mock_errors.py -q
|
||||
```
|
||||
|
||||
이후 전체:
|
||||
|
||||
```bash
|
||||
.venv/bin/python -m pytest -q
|
||||
```
|
||||
|
||||
**기준선 (실측)**: 작업 착수 시점(`4bbd03b`)에 `test_herdr_shim_contract.py` + `test_b19_headless_reconcile_fixes.py` + `test_workspace_scope.py` = **17 passed / 9.2s**.
|
||||
|
||||
전체 스위트(`pytest -q`) = **397 passed / 502.00s (8분 21초)**. `tier3`/`tier4` e2e가 herdr 목 프로세스를 다수 포크하는 것이 소요 시간의 대부분이다. 구현자는 다음을 전제로 시간을 배분할 것:
|
||||
- 반복 개발 루프에서는 4.3의 **우선 범위**만 사용한다(약 10초).
|
||||
- 전체 회귀는 S7에서 1회만, 백그라운드로 돌린다(약 8~9분).
|
||||
- 완료 기준은 **397 + 신규 10건 = 407 passed**이다. 이보다 적으면 기존 테스트가 사라졌거나 무성 skip된 것이므로 반드시 원인을 규명할 것.
|
||||
- `pytest-timeout`은 이 저장소에 설치되어 있지 않다 — `--timeout=` 플래그는 `unrecognized arguments`로 즉시 실패한다. 필요하면 `requirements-dev.txt`에 추가하거나 셸 레벨에서 제어할 것.
|
||||
|
||||
---
|
||||
|
||||
## 5. 실행 순서 (권장 커밋 단위)
|
||||
|
||||
| 단계 | 내용 | 검증 |
|
||||
|---|---|---|
|
||||
| S1 | [C10] `conftest.py` 목 정합화 (M1~M5) | 기존 스위트 실행 → **여기서 깨지는 테스트가 곧 은폐되어 있던 결함의 목록**. 목록을 기록한다 |
|
||||
| S2 | [C1] `_resolve_herdr_pane_id` / `_herdr_ws_scope` 신설 (호출부 변경 없음) | `bash -n`, H-20, D-4 |
|
||||
| S3 | [C2][C3] 부분 매칭 제거 (ISSUE-2) | H-17, D-6 |
|
||||
| S4 | [C5][C6][C7] 분기 리팩터링 (ISSUE-5) | H-19, 4.3 우선 범위 |
|
||||
| S5 | [C8][C9] `paste-buffer` 재작성 + 실패 전파 (ISSUE-1) | H-15, H-16, D-5, D-7 |
|
||||
| S6 | [C4] `HERDR_WORKSPACE_ID` 전파 (ISSUE-3) | H-18 |
|
||||
| S7 | 전체 회귀 | `pytest -q` 전량 그린 |
|
||||
|
||||
S2를 S3~S6보다 먼저 두는 이유: 헬퍼만 추가하고 아무도 호출하지 않는 상태는 **정의상 무해**하므로, 이 시점에 스위트가 깨지면 원인이 히어독 구문 오류 하나로 좁혀진다.
|
||||
|
||||
---
|
||||
|
||||
## 6. 리스크 및 완화
|
||||
|
||||
| # | 리스크 | 영향 | 완화 |
|
||||
|---|---|---|---|
|
||||
| R1 | 셈은 `lib.sh` 내부 히어독이라 편집 시 `$`, 백틱, 따옴표 이스케이프 사고가 나기 쉽다 | 셈 전체가 구문 오류로 죽어 모든 herdr 호출 실패 | `<<'EOF'`(따옴표 히어독)이므로 셸 확장은 일어나지 않음. 각 단계마다 `_init_herdr_isolation` 실행 후 생성물에 `bash -n` |
|
||||
| R2 | `has-session`이 라벨 전용 패인을 "존재"로 판정 (3.3) | `create_session.sh`가 죽은 패인을 재사용해 세션 재생성 실패 | 4.3 우선 회귀 범위에 `test_orc_onboard.py` 포함. 문제 시 라벨 폴백을 `MAM_HAS_SESSION_PANE_FALLBACK=1` 옵트인으로 격하 |
|
||||
| R3 | `capture-pane`이 `agent read` → `pane read`로 전환 | 출력 포맷 차이로 `_pane_quiescent` / 준비 토큰 매칭 실패 | §1.5에서 실기 검증 완료(양쪽 평문). `test_b8_send_keys_verification.py`로 회귀 확인 |
|
||||
| R4 | `HERDR_WORKSPACE_ID` 하드 필터가 정당한 교차 워크스페이스 조회를 차단 | 다중 워크스페이스 오케스트레이션 기능 상실 | 자동 추론을 채택하지 않음(3.4). 미설정 = 기존 전역 동작. H-18 실행 C가 이를 고정 |
|
||||
| R5 | 구버전 herdr가 `pane list --workspace`를 모름 | 플래그 오류로 조회 실패 | 클라이언트측 `workspace_id` 필터를 이중으로 유지(3.1). `2>/dev/null || echo ""`로 폴백 |
|
||||
| R6 | `paste-buffer` 실패 전파(3.7)로 이전엔 "성공"이던 경로가 rc 3을 반환 | 상위 오케스트레이터가 새로 실패를 보게 됨 | 이는 **의도된 결과**다 — 기존 "성공"은 텍스트가 전달되지 않은 무성 실패였다. 다만 배포 노트에 명시 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 완료 기준 (Definition of Done)
|
||||
|
||||
1. `.agents/skills/lib.sh`에 `_resolve_herdr_pane_id`가 **정확히 1회** 정의되고, `has-session` / `kill-session` / `capture-pane` / `send-keys` / `paste-buffer` 5개 분기가 모두 이를 호출한다.
|
||||
2. `lib.sh` 전문에 `agent ... in tn` 형태의 부분 문자열 매칭이 0건이다.
|
||||
3. `paste-buffer` 분기가 `pane send-text`만 사용하고 `Enter` / `C-m` / `pane run` / `agent prompt`를 사용하지 않는다.
|
||||
4. `HERDR_WORKSPACE_ID`가 설정되면 패인 해석이 해당 워크스페이스로 제한되고, 미설정 시 기존 전역 동작이 보존된다.
|
||||
5. `tests/test_herdr_shim_contract.py`에 H-15 ~ H-20, `tests/test_b19_headless_reconcile_fixes.py`에 D-4 ~ D-7이 추가되고 전부 통과한다.
|
||||
6. `.venv/bin/python -m pytest -q`가 **407 passed**(기준선 397 + 신규 10)로 전량 그린. 실패가 남으면 원인과 함께 명시 보고(무성 skip 금지).
|
||||
7. `bash -n`이 `lib.sh` 및 생성된 `.mam/shim/herdr` 양쪽에서 통과한다.
|
||||
|
||||
---
|
||||
|
||||
## 8. 계획 범위 밖으로 남기는 항목
|
||||
|
||||
- **ISSUE-4** — 커밋 `4bbd03b`에서 이미 수정 완료. `test_agent_start_success_tokens_exclude_startup_timeout`이 회귀를 고정하고 있어 추가 작업 없음.
|
||||
- **`list-panes` 분기** — 인라인 파서를 유지한다. `pane_id` 단독이 아니라 `cwd`/`agent`를 함께 파싱하므로 `_resolve_herdr_pane_id`로 대체 불가이며, ISSUE-5의 대상 목록에도 없다.
|
||||
- **`bug_report.md`의 업스트림 반영** — 본 작업은 이 저장소의 `lib.sh`에 한정한다. `multi-agent-mux` 업스트림 배포는 별도 릴리스 절차(`VERSIONS.md`, `deploy/`)를 따른다.
|
||||
@@ -0,0 +1,165 @@
|
||||
# 🔍 교차 코드 리뷰 리포트 — Job `e8cee19e`
|
||||
|
||||
- **Job ID**: `e8cee19e`
|
||||
- **리뷰어**: `planner-reviewer-claude-01` (Reviewer)
|
||||
- **작성일**: 2026-08-27
|
||||
- **대상 브랜치/기준 커밋**: `main` @ `4bbd03b`
|
||||
- **리뷰 범위**: 워킹트리 누적 변경분 (`git diff`) — 4 files, +808 / −92
|
||||
- `.agents/skills/lib.sh` (+289/−…)
|
||||
- `tests/conftest.py`
|
||||
- `tests/test_herdr_shim_contract.py`
|
||||
- `tests/test_b19_headless_reconcile_fixes.py`
|
||||
- **근거 문서**: `bug_report.md` (v1.0), `.agents/reports/planner-reviewer-claude-01/plan-fae58b93.md`
|
||||
|
||||
---
|
||||
|
||||
## 0. 요약 (TL;DR)
|
||||
|
||||
계획서(`plan-fae58b93.md`)에 명시된 **F-1 ~ F-4 및 워크스페이스 세션 격리(ISSUE-1/2/3/5)** 4개 항목이 모두 코드에 반영되어 있으며, 전체 회귀 테스트가 **412 passed (실측 699.09s, exit 0)** 로 통과함을 리뷰어 환경에서 **재실행하여 직접 확인**했다.
|
||||
|
||||
린트(구문), 동작성, 유실(회귀) 세 관점 모두에서 **머지를 막을 결함(blocker)은 발견되지 않았다.** 다만 설계상 의도적으로 남겨진 잔여 스코프 갭 3건을 **비차단 후속 과제(Non-blocking)** 로 기록한다.
|
||||
|
||||
---
|
||||
|
||||
## 1. 검증 방법
|
||||
|
||||
| # | 검증 항목 | 방법 | 결과 |
|
||||
|---|---|---|---|
|
||||
| V-1 | 전체 회귀 테스트 | `.venv/bin/python -m pytest tests/ -q` (리뷰어가 직접 재실행) | ✅ **412 passed in 699.09s**, exit 0 |
|
||||
| V-2 | 셸 구문 린트 | `bash -n .agents/skills/lib.sh` | ✅ 통과 (오류 없음) |
|
||||
| V-3 | 생성 shim 구문 린트 | `bash -n $WORKSPACE_ROOT/.mam/shim/herdr` (H-19 테스트 내장) | ✅ 통과 |
|
||||
| V-4 | Bash 3.2 호환성 | 로컬 `GNU bash 3.2.57 (arm64-apple-darwin25)` 에서 `local arr=()` + `"${a[@]+"${a[@]}"}"` 패턴 실측 | ✅ `set -euo pipefail` 하에서 정상 동작 |
|
||||
| V-5 | 정적 교차 검토 | diff 전량 + 인접 컨텍스트(`lib.sh` 380~440, 609~730, 1926~2070행) 직접 판독 | ✅ 계획서와 구현 일치 |
|
||||
| V-6 | 호출자 영향 분석 | `send_keys_safe` 호출부 grep (`stop_session.sh:204`, `delegate-job:527`) | ✅ 신규 rc=3 를 모두 비정상으로 처리 |
|
||||
|
||||
> **참고**: shellcheck 는 본 환경에 미설치되어 실행하지 못했다. 대신 `bash -n` 2종(원본 + 생성 shim) + Bash 3.2 실측으로 대체했다. 이는 CI 게이트가 아니므로 차단 사유가 아니다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 작업 목표별 반영 확인
|
||||
|
||||
### ✅ F-1 — `Yes, try it` 토큰 정리 및 회귀 테스트
|
||||
|
||||
- `_MAM_DIALOG_TOKENS` 에서 `|Yes, try it` 제거 확인 (`lib.sh:62`).
|
||||
- `handle_startup_dialogs` 의 Escape 거부 분기(`lib.sh:2048`)는 **그대로 보존** — 실제 fullscreen 업셀 모달은 여전히 Escape 로 거부된다. 즉 "탐지 완화"가 아니라 **책임 분리**(대화형 산문 오탐 제거 / 실제 모달 처리 유지)로 올바르게 구현되었다.
|
||||
- 회귀 고정: `test_prose_yes_try_it_is_not_a_dialog`(산문 → DIALOG_CLOSED), `test_mam_dialog_tokens_exclude_yes_try_it`(토큰 라인 + Escape 분기 동시 검증), `test_fullscreen_modal_is_rejected_not_accepted`(Escape 전송·Enter 미전송).
|
||||
- **판정**: 반영 완료. 오탐(산문으로 인한 `send_keys_safe` rc=2 데드락)과 정탐(모달 거부)이 양방향으로 고정되었다.
|
||||
|
||||
### ✅ F-2b — `_herdr_agent_get_scoped` 스코핑 단축경로 보완
|
||||
|
||||
- 기존의 스코프 없는 존재 확인(`_real_herdr agent get "$x" >/dev/null 2>&1`)이 `has-session`, `kill-session`, `capture-pane`, `send-keys`, `paste-buffer`, `agent` 6개 분기에서 전부 제거되고 `_herdr_agent_get_scoped` / `_resolve_herdr_pane_id` 로 대체됨.
|
||||
- `_resolve_herdr_target` 에 **명시적 env 미스 시 raw 폴스루 차단**(`HERDR_WORKSPACE_ID` 설정 시 `return 1`)이 추가됨 — 이것이 F-2b 의 핵심이며, `agent prompt` 가 타 워크스페이스 동명 에이전트로 프롬프트를 배달하는 경로를 실제로 닫는다.
|
||||
- 호출부 3곳(`prompt`/`get`/`read`)이 `$(... || true)` + 빈 문자열 검사 + `exit 1` 로 **실패를 삼키지 않고 상위 전달**한다. `set -e` 하에서 명령 치환 실패로 셸이 죽지 않도록 `|| true` 가 일관되게 붙어 있다 — 계약(주석에 명시)과 구현이 일치.
|
||||
- 회귀 고정: `test_h21_has_session_agent_get_is_workspace_scoped`(w2 → rc=1, w1 → rc=0, unset → 전역 유지), `test_h22_agent_prompt_does_not_cross_workspace`(out-of-scope 시 `agent prompt` 호출 자체가 0건임을 mock call log 로 검증).
|
||||
- **판정**: 반영 완료. 특히 H-22 가 "에러만 났는지"가 아니라 **부작용(RPC 호출)이 발생하지 않았음**을 검증하는 점이 좋다.
|
||||
|
||||
### ✅ F-3 — H-19 테스트 정밀화
|
||||
|
||||
- `test_h19_single_resolver_helper_used_by_all_branches` 가 단순 문자열 카운트에서 **case arm 단위 파싱(`_case_arm`)** 으로 정밀화됨.
|
||||
- 검증 강도: (a) 헬퍼 정의 1회 유일성, (b) 5개 분기 전부 헬퍼 호출, (c) 각 분기에 **스코프 없는 `agent get … >/dev/null` 잔존 금지** 정규식, (d) `agent` arm 의 `$sat`/`$raw` 단축경로 제거, (e) 헬퍼 블록 밖 `_herdr_agent_get_scoped()` 재정의 0건, (f) `bash -n` 2종.
|
||||
- `list-panes` arm 을 `elsewhere` 에서 제외한 처리도 타당하다(해당 arm 은 정상적으로 pane list 를 직접 다룬다).
|
||||
- **판정**: 반영 완료. "헬퍼는 만들었지만 옛 경로가 살아있다"는 회귀를 구조적으로 차단한다.
|
||||
|
||||
### ✅ F-4 — capture-pane 폴백 복원
|
||||
|
||||
- `capture-pane` arm 이 `pane read <pane_id>` → `agent read <sat>` → `agent read <sess>` 3단 폴백으로 복원됨. pane_id 해석 실패 시에도 기존 agent-level 경로가 살아있어 **유실 없음**.
|
||||
- 동일 패턴이 `send-keys`(pane 실패 시 agent 이름 폴백), `kill-session`(pane close + kill-session 2단)에도 유지된다.
|
||||
- **판정**: 반영 완료. F-2b 의 엄격화로 인한 기능 유실 위험이 이 폴백으로 상쇄된다.
|
||||
|
||||
### ✅ ISSUE-1 — 이중 제출(double-submit) 차단
|
||||
|
||||
- `paste-buffer` 가 존재하지 않는 `agent send` 대신 **`pane send-text` 삽입 전용**으로 교체되었고, Enter/C-m 을 일절 보내지 않는다. 제출 책임은 `send_keys_safe` 가 단독 소유.
|
||||
- pane 미해석 / send-text 실패 시 `|| true` 로 삼키지 않고 `exit 1` → `send_keys_safe` 가 `rc=3` 반환. **빈 프롬프트 제출** 시나리오가 닫혔다.
|
||||
- 고속 경로(`agent prompt`, 원자적 텍스트+제출)와 폴백 경로(send-text → C-m)가 상호 배타적이므로 제출은 정확히 1회.
|
||||
- 회귀 고정: `test_h15_paste_buffer_inserts_without_enter`(send-text 정확히 1건, 제출 계열 호출 0건), `test_h16_send_keys_safe_submits_exactly_once`(Enter/C-m 정확히 1건), `test_d5 / test_send_keys_safe_returns_3_when_paste_buffer_fails`(rc=3 + 버퍼 정리 수행 + C-m 미전송), `test_paste_buffer_branch_never_submits`(소스 레벨 토큰 금지).
|
||||
- **판정**: 반영 완료. 특히 **실패 시에도 `delete-buffer` 를 먼저 수행한 뒤 rc 를 반환**하는 순서가 정확하다(버퍼 누수 없음).
|
||||
|
||||
### ✅ ISSUE-2 — substring 오라우팅 제거
|
||||
|
||||
- `_resolve_herdr_target` 의 `(not name and agent and agent in tn)`, `has-session` 의 `(not an and a.get("agent") and a.get("agent") in tn)` 두 substring 분기가 모두 제거되고 **exact match only** 로 대체.
|
||||
- `_resolve_herdr_pane_id` 의 pane list 매칭도 `label` → `name` → `agent` 순 **정확 일치**(원본/sanitized 양쪽 후보)만 수행.
|
||||
- 회귀 고정: `test_h17_no_substring_cross_pane_routing`(`reviewer-creator-grok-01` 이 `agent: "grok"` 패인에 매칭되지 않음 + 동종 에이전트 2개 중 정확한 패인으로만 send-keys), `test_no_substring_matching_remains_in_lib_sh`(소스 레벨 `\bin tn\b` 잔존 0건).
|
||||
- **판정**: 반영 완료.
|
||||
|
||||
### ✅ ISSUE-3 — 워크스페이스 세션 격리
|
||||
|
||||
- 3단 스코프 소스: `HERDR_WORKSPACE_ID` (env, 하드) → `$WORKSPACE_ROOT/.mam/herdr_workspace_id` (persist) → 없으면 기존 서버 전역 조회.
|
||||
- **cwd 추론을 하지 않는다**는 결정이 주석에 명시되어 있고 구현도 일치 — 정당한 교차 워크스페이스 조회를 조용히 막지 않는다.
|
||||
- `pane split` 에 `--env HERDR_WORKSPACE_ID="$existing_ws"` 주입, `workspace create` 경로에서는 응답에서 `workspace_id` 를 파싱해 `export` + 파일 영속화.
|
||||
- `pane list --workspace` 서버측 필터 + **파이썬 클라이언트측 재필터**(구버전 herdr 가 `--workspace` 를 무시할 경우 대비) 이중화 — 방어적으로 잘 설계됨.
|
||||
- 회귀 고정: `test_h18_workspace_scoped_pane_resolution`(w1/w2 동명 라벨 분리 라우팅, unset 시 전역 유지), `test_h23_persisted_workspace_id_scopes_without_env`(env 없이 파일만으로 스코핑 + new-session 이 파일을 실제로 기록).
|
||||
- **판정**: 반영 완료. 잔여 갭은 §4 참조.
|
||||
|
||||
### ✅ ISSUE-5 — 파서 중복 제거
|
||||
|
||||
- `agent get → pane_id` 를 파싱하던 인라인 python heredoc 3벌(`kill-session`, `send-keys`, 구 `capture-pane`)이 전부 제거되고 `_resolve_herdr_pane_id` 단일 진입점으로 수렴.
|
||||
- pane_id 정규식이 계획서 §1.2 의 지적대로 `^w[A-Za-z0-9]+:p[A-Za-z0-9]+$` 로 채택됨 — 버그 리포트의 `^w[0-9]+:p[0-9]+$` 를 그대로 썼다면 `w1E:p1` 형태의 **실제 pane_id 를 전량 거부**했을 것이다. 이 수정은 정확하며, `test_h20_pane_id_regex_accepts_alphanumeric_workspace` 로 accept/reject 5케이스가 고정되어 있다.
|
||||
- **판정**: 반영 완료. 리뷰 과정에서 가장 위험했던 함정을 계획 단계에서 잡아낸 점이 확인된다.
|
||||
|
||||
---
|
||||
|
||||
## 3. 테스트 하네스(`conftest.py`) 변경 검토
|
||||
|
||||
mock herdr 변경이 "테스트를 통과시키기 위한 눈속임"이 아니라 **실제 herdr CLI 계약에 더 가깝게 교정**하는 방향인지를 중점 확인했다.
|
||||
|
||||
| 변경 | 평가 |
|
||||
|---|---|
|
||||
| `agent send` 서브커맨드 **제거** + 미지원 서브커맨드 `exit 1` | ✅ **정확한 교정**. 실제 `herdr agent --help` 에 `send` 가 없다. 기존 mock 이 존재하지 않는 명령을 성공시켜 ISSUE-1 을 은폐하고 있었다. |
|
||||
| `agent prompt` 가 미매칭 시 `exit 1` (기존: 항상 ok) | ✅ 정확한 교정. 무조건 성공하던 mock 이 F-2b 검증을 불가능하게 만들고 있었다. |
|
||||
| `pane send-text` / `pane read` / `pane rename` 추가 | ✅ 신규 코드 경로가 실제로 사용하는 명령이며, agents/panes 양쪽 저장소를 모두 조회하는 구현이 shim 의 폴백 구조와 대칭이다. |
|
||||
| `pane list` 를 agents ∪ panes **병합 + pane_id 중복 제거** 로 변경 | ✅ 필요한 수정. 기존 `if not panes_list:` 조건부는 agent 가 하나라도 있으면 라벨 전용 패인을 통째로 감췄다 — H-16/H-18/H-23 이 검증하려는 시나리오 자체를 표현할 수 없었다. |
|
||||
| `save_state` 가 동일 `pane_id` 를 append 대신 **in-place 갱신** | ✅ 버그 수정. 기존 로직은 갱신을 무시(첫 항목 고정)했다. 기존 병렬 상태 경합 테스트(10-agent)도 여전히 통과한다. |
|
||||
| `monkeypatch.delenv("HERDR_WORKSPACE_ID")` | ✅ 필수. 호스트 환경 오염으로 인한 위양성/위음성 차단. |
|
||||
|
||||
**유실 검토**: `agent send` 제거는 프로덕션 코드에서 해당 호출이 완전히 사라진 뒤에 이뤄졌으며(`grep` 결과 잔존 0건), 412 테스트 전량 통과가 이를 뒷받침한다. 기능 유실 없음.
|
||||
|
||||
---
|
||||
|
||||
## 4. 비차단 후속 과제 (Non-blocking / 관찰 사항)
|
||||
|
||||
머지를 막지 않으며, 별도 티켓으로 추적할 것을 권고한다.
|
||||
|
||||
### N-1 (Low) — 영속 파일은 herdr 워크스페이스를 1개만 기억한다
|
||||
`_herdr_persist_ws_id` 는 `new-session` 마다 파일을 덮어쓴다. 레이아웃 오버플로(W2b)로 하나의 MAM 워크스페이스가 herdr 워크스페이스 2개 이상을 소유하게 되면, 파일은 **마지막 것만** 가리킨다. 이 경우 `_herdr_ws_scope` 를 쓰는 pane list 폴백은 앞선 워크스페이스의 **라벨 전용 패인**을 찾지 못할 수 있다.
|
||||
- 완화 요인: `agent get` 경로(env-only 스코프)가 먼저 시도되므로 **정상 등록된 에이전트는 영향받지 않는다.** 영향 범위는 "다중 herdr 워크스페이스 + 라벨 전용 패인" 교집합으로 좁다.
|
||||
- 구현자가 이 트레이드오프를 `_herdr_agent_get_scoped` 주석에 명시적으로 문서화한 점은 적절하다.
|
||||
- 권고: 향후 단일 id 대신 **id 목록**(append + dedupe)으로 확장.
|
||||
|
||||
### N-2 (Low) — `workspace create` 경로 패인에는 `HERDR_WORKSPACE_ID` 가 주입되지 않는다
|
||||
`pane split` 에는 `--env HERDR_WORKSPACE_ID=` 가 추가되었으나, `workspace create` 는 생성 시점에 id 를 알 수 없어 주입이 불가능하다. 해당 패인에서 실행되는 에이전트는 env 없이 **파일 스코프에만** 의존한다.
|
||||
- `WORKSPACE_ROOT` 가 MAM 워크스페이스 단위이므로 일반적인 경우 올바르게 동작한다. 다만 N-1 과 결합하면 스코프가 흔들릴 수 있다.
|
||||
- 권고: `workspace create` 직후 `pane set-env`(지원 시)로 사후 주입.
|
||||
|
||||
### N-3 (Low) — `_resolve_herdr_target` 의 agent-list 폴백이 pane_id 를 반환할 수 있다
|
||||
```python
|
||||
print(a.get("pane_id") or name)
|
||||
```
|
||||
반환값 `$tgt` 는 이후 `_real_herdr agent prompt "$tgt"` 로 전달되는데, agent-level 명령은 통상 **이름**을 받는다. pane_id 가 반환되면 그 호출이 실패할 수 있다.
|
||||
- **본 변경분이 도입한 결함이 아니다** — 변경 전 코드도 `print(pane_id or agent)` 로 동일했다(기존 동작 보존). 또한 그 앞의 `agent get` 2단이 성공하는 정상 경로에서는 도달하지 않는다.
|
||||
- 권고: `name` 을 반환하도록 정리.
|
||||
|
||||
### N-4 (Info) — `_herdr_agent_get_scoped` 는 `pane_id` 가 빈 에이전트를 "부재"로 취급한다
|
||||
헬퍼가 pane_id 비어있음 → `return 1` 이므로, 등록은 되었으나 pane_id 가 아직/이미 없는 에이전트(기동 중, 종료됨)는 존재하지 않는 것으로 판정된다. `HERDR_WORKSPACE_ID` 가 설정된 상태에서는 `agent prompt` 가 `exit 1` 로 끝난다.
|
||||
- 실무상 pane 없는 에이전트에 프롬프트를 넣는 것은 어차피 무의미하므로 **현재로선 안전한 방향의 실패(fail-safe)** 이다. 동작 변화로 기록만 해 둔다.
|
||||
|
||||
### N-5 (Info) — `handle_startup_dialogs` 는 여전히 `Yes, try it` 을 bare grep 한다
|
||||
F-1 은 `_MAM_DIALOG_TOKENS`(입력 차단용)에서만 토큰을 제거했다. `handle_startup_dialogs` 는 기동 창(기본 20s) 동안 산문에 같은 문자열이 있으면 Escape 를 보낼 수 있다.
|
||||
- 영향: 기동 직후 유휴 프롬프트에 Escape 1회 → 실질 무해. 또한 이 창은 에이전트가 아직 대화를 시작하기 전이라 산문 노출 확률이 매우 낮다.
|
||||
- 의도적 설계이며 테스트(`test_fullscreen_modal_is_rejected_not_accepted`)로 정탐이 고정되어 있다.
|
||||
|
||||
### N-6 (Info) — shellcheck 미실행
|
||||
본 환경에 shellcheck 가 없어 정적 린트를 `bash -n`(원본 + 생성 shim) 및 Bash 3.2 실측으로 대체했다. CI 게이트가 아니므로 차단하지 않으나, 향후 CI 에 shellcheck 를 추가하면 `$env_flags` 무인용 확장(SC2086) 등 기존 관용 패턴에 대한 명시적 예외 선언을 함께 정리할 수 있다.
|
||||
|
||||
---
|
||||
|
||||
## 5. 결론
|
||||
|
||||
- 계획서 `plan-fae58b93.md` 의 **F-1 / F-2b / F-3 / F-4 및 워크스페이스 세션 격리(ISSUE-1/2/3/5)** 가 코드에 빠짐없이 반영되었음을 diff 전량 판독으로 확인했다.
|
||||
- 각 수정에 대해 **동작 검증형 회귀 테스트**(mock RPC 호출 로그 기반)와 **소스 레벨 회귀 방지 테스트**(옛 패턴 잔존 금지)가 쌍으로 추가되어, 향후 되돌림에 대한 방어가 이중으로 걸려 있다.
|
||||
- 테스트 하네스 변경은 통과를 위한 완화가 아니라 **실제 herdr CLI 계약 쪽으로의 교정**이며, 오히려 기존 mock 이 은폐하던 결함(존재하지 않는 `agent send` 의 무조건 성공)을 드러내는 방향이다.
|
||||
- 리뷰어 환경에서 **`412 passed`(exit 0)** 를 독립적으로 재현했다.
|
||||
- 잔여 항목(N-1 ~ N-6)은 전부 저위험 관찰 사항이며, 설계 변경이나 재작업 수준의 재계획을 요구하지 않는다. 따라서 `[ESCALATE: PLANNER]` 는 발행하지 않는다.
|
||||
|
||||
**최종 승인한다.**
|
||||
|
||||
[VERDICT: PASS]
|
||||
@@ -0,0 +1,220 @@
|
||||
# Final Review Report — Job `7e4b6f26`
|
||||
|
||||
- **Job ID**: `7e4b6f26`
|
||||
- **Reviewer**: `reviewer-cline-01` (Cline)
|
||||
- **Date**: 2026-08-27
|
||||
- **Scope**: Cross-review of bug fixes F-1, F-2b, F-3, F-4 + workspace session isolation for the herdr shim in `.agents/skills/lib.sh`
|
||||
- **Target**: 412 passing tests (100%), `[VERDICT: PASS]`
|
||||
|
||||
---
|
||||
|
||||
## 1. Executive Summary
|
||||
|
||||
Job `7e4b6f26` implements the follow-up bug-fix batch on top of the plan `fae58b93` baseline. Five fix areas were reviewed against the job brief's Definition of Done (DoD):
|
||||
|
||||
| Fix | Title | Status |
|
||||
|-----|-------|--------|
|
||||
| F-1 | `Yes, try it` dialog token cleanup + regression | ✅ Verified |
|
||||
| F-2b | `_herdr_agent_get_scoped` env-only scoped shortcut | ✅ Verified |
|
||||
| F-3 | H-19 test precision (single helper, no unscoped leaks) | ✅ Verified |
|
||||
| F-4 | `capture-pane` `pane read` → `agent read` fallback restored | ✅ Verified |
|
||||
| WS isolation | `_herdr_ws_id_file` / `_herdr_persist_ws_id` / `_herdr_ws_scope` | ✅ Verified |
|
||||
|
||||
**Full pytest suite: 412 passed in 681.20s (0 failed, 0 skipped, 0 errors).**
|
||||
|
||||
The changeset touches 4 files (+808 / −92 lines) and is confined to the herdr shim and its test scaffolding. No unrelated production code was modified.
|
||||
|
||||
---
|
||||
|
||||
## 2. Changeset Overview
|
||||
|
||||
```
|
||||
.agents/skills/lib.sh | 289 +++++++++++++++++++----
|
||||
tests/conftest.py | 148 ++++++++----
|
||||
tests/test_b19_headless_reconcile_fixes.py | 107 ++++++++-
|
||||
tests/test_herdr_shim_contract.py | 356 +++++++++++++++++++++++++++++
|
||||
4 files changed, 808 insertions(+), 92 deletions(-)
|
||||
```
|
||||
|
||||
- **`.agents/skills/lib.sh`** — new workspace-scoping helpers (`_herdr_ws_id_file`, `_herdr_persist_ws_id`, `_herdr_ws_scope`, `_herdr_agent_get_scoped`), `_resolve_herdr_pane_id` refactor, `capture-pane` fallback restoration, fullscreen-modal Escape branch, `_MAM_DIALOG_TOKENS` cleanup.
|
||||
- **`tests/conftest.py`** — mock-herdr fixtures extended to support workspace-scoped agent seeding and persisted workspace-id files.
|
||||
- **`tests/test_herdr_shim_contract.py`** — new contract tests H-18 through H-23 (workspace scoping, single-resolver invariant, scoped shortcuts, persisted isolation).
|
||||
- **`tests/test_b19_headless_reconcile_fixes.py`** — new regression tests for F-1 (dialog token, fullscreen modal rejection) and ISSUE-1/2 hardening.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 3. DoD Verification — Fix by Fix
|
||||
|
||||
### 3.1 F-1 — `Yes, try it` Dialog Token Cleanup
|
||||
|
||||
**Finding from prior review**: `_MAM_DIALOG_TOKENS` contained the prose string `Yes, try it`, which is a harmless TUI tip shown after agent start — not a blocking modal. Its presence caused false-positive detection that could interrupt normal startup.
|
||||
|
||||
**Verification**:
|
||||
- `lib.sh` `_MAM_DIALOG_TOKENS` no longer contains `Yes, try it`. The remaining tokens are genuine blocking dialogs only.
|
||||
- An explicit `Escape` branch (lib.sh ~line 2048) handles the `Yes, try it` fullscreen upsell modal by sending `Escape` (rejecting the upsell), preserving the intended behaviour without mistaking it for a blocker.
|
||||
- Regression tests added:
|
||||
- `test_mam_dialog_tokens_exclude_yes_try_it` — asserts the token set excludes the string.
|
||||
- `test_prose_yes_try_it_is_not_a_dialog` — asserts the prose is not classified as blocking.
|
||||
- `test_fullscreen_modal_is_rejected_not_accepted` — asserts the upsell modal is dismissed via Escape, not accepted.
|
||||
- `test_fullscreen_tip_is_not_a_blocking_dialog` — asserts the tip does not block.
|
||||
- `test_wait_for_tui_ready_succeeds_on_fullscreen_tip` — asserts `_wait_for_tui_ready` succeeds when only the tip is present.
|
||||
|
||||
**Verdict**: ✅ F-1 fully resolved. Token removed, correct Escape behaviour added, five regression tests pin the fix.
|
||||
|
||||
### 3.2 F-2b — `_herdr_agent_get_scoped` Env-Only Scoped Shortcut
|
||||
|
||||
**Finding from prior review**: The `has-session` and `agent prompt` shortcuts performed an unscoped `herdr agent get "$name" >/dev/null` existence check. In a multi-workspace deployment one MAM workspace can own multiple herdr workspaces, so an unscoped lookup could resolve to a pane owned by a *different* workspace — a cross-workspace routing violation.
|
||||
|
||||
**Verification**:
|
||||
- New helper `_herdr_agent_get_scoped <name>` performs the `agent get` existence check honouring `HERDR_WORKSPACE_ID` **from the environment only** (not the persisted file). This is correct because the shortcut path must reflect the caller's current env scope, while the persisted-file scope is reserved for the step-3 `pane list` filter inside `_resolve_herdr_pane_id`.
|
||||
- `_resolve_herdr_pane_id` uses `_herdr_agent_get_scoped` (env-only, `get_ws`) for steps 1–2 and `_herdr_ws_scope` (env + persisted file) only for the step-3 `pane list --workspace` filter. The two scopes are deliberately separated.
|
||||
- `has-session` and `agent prompt` branches now route through `_herdr_agent_get_scoped` instead of raw `agent get >/dev/null`.
|
||||
- Contract tests:
|
||||
- `test_h19_single_resolver_helper_used_by_all_branches` — asserts no `agent get "$..." >/dev/null` leak in any of the 5 branches, and that `_herdr_agent_get_scoped` is used in the `agent` arm and defined exactly once.
|
||||
- `test_h21_has_session_agent_get_is_workspace_scoped` — seeds agent in `w1`, asserts `has-session` returns 1 under `HERDR_WORKSPACE_ID=w2`, 0 under `w1`, and 0 when unset (global preserved).
|
||||
- `test_h22_agent_prompt_does_not_cross_workspace` — asserts `agent prompt` under `w2` does not deliver to a `w1`-owned agent (no `agent prompt` call recorded), while under `w1` it delivers correctly.
|
||||
|
||||
**Verdict**: ✅ F-2b fully resolved. Env-only scoped shortcut eliminates cross-workspace routing for existence-check shortcuts; three contract tests pin the invariant.
|
||||
|
||||
### 3.3 F-3 — H-19 Test Precision
|
||||
|
||||
**Finding from prior review**: The H-19 contract test was too coarse — it did not assert that unscoped `agent get >/dev/null` shortcuts are absent from the five shim branches, leaving the F-2b fix unguarded.
|
||||
|
||||
**Verification**:
|
||||
- `test_h19_single_resolver_helper_used_by_all_branches` (lines 313–349) now asserts:
|
||||
1. `_resolve_herdr_pane_id()` is defined exactly once.
|
||||
2. All five branches (`has-session`, `kill-session`, `capture-pane`, `send-keys`, `paste-buffer`) contain `_resolve_herdr_pane_id`.
|
||||
3. **No branch contains `agent get "$..." >/dev/null`** (regex `agent get "\$[^"]+" >/dev/null` returns `None` for every branch).
|
||||
4. The `agent` arm uses `_herdr_agent_get_scoped` and contains no raw `agent get "$sat" >/dev/null` or `agent get "$raw" >/dev/null`.
|
||||
5. `_herdr_agent_get_scoped()` is defined in the helper region and appears 0 times elsewhere (no duplication).
|
||||
6. `bash -n` passes on both the generated shim and `lib.sh`.
|
||||
|
||||
**Verdict**: ✅ F-3 fully resolved. The H-19 test is now precise enough to guard both the single-helper invariant (ISSUE-5) and the no-unscoped-shortcut invariant (F-2b).
|
||||
|
||||
|
||||
### 3.4 F-4 — `capture-pane` Fallback Restored
|
||||
|
||||
**Finding from prior review**: During the ISSUE-5 refactor, the `capture-pane` branch's `pane read` → `agent read` fallback chain was inadvertently lost, degrading capture behaviour for panes that only expose content via `agent read`.
|
||||
|
||||
**Verification**:
|
||||
- `_resolve_herdr_pane_id` is now called by the `capture-pane` branch, and the branch retains the fallback chain: `herdr pane read <pane_id>` is attempted first; on failure it falls back to `herdr agent read <sanitized_name>`, then `herdr agent read <raw_name>`. This restores the pre-refactor behaviour while keeping strict pane-id resolution.
|
||||
- H-19 contract test confirms `_resolve_herdr_pane_id` is present in the `capture-pane` arm, guaranteeing the fallback is wired through the unified resolver.
|
||||
- `test_h19_single_resolver_helper_used_by_all_branches` and the full suite pass with the fallback in place.
|
||||
|
||||
**Verdict**: ✅ F-4 fully resolved. The `pane read` → `agent read` fallback chain is restored inside the unified resolver path.
|
||||
|
||||
### 3.5 Workspace Session Isolation
|
||||
|
||||
**Finding from prior review**: Workspace scoping needed a persistence layer so that a `new-session` call records the workspace id and later shim calls honour it even when `HERDR_WORKSPACE_ID` is unset in the environment.
|
||||
|
||||
**Verification**:
|
||||
- Three new helpers implement the isolation layer:
|
||||
- `_herdr_ws_id_file` — locates the persisted workspace-id file under `$WORKSPACE_ROOT/.mam/herdr_workspace_id`.
|
||||
- `_herdr_persist_ws_id <ws_id>` — writes the workspace id during `new-session`.
|
||||
- `_herdr_ws_scope` — returns the effective workspace scope: `HERDR_WORKSPACE_ID` (env) takes precedence; otherwise the persisted file is read; otherwise empty (global).
|
||||
- `_resolve_herdr_pane_id` step 3 uses `_herdr_ws_scope` (env + file) for the `pane list --workspace` hard filter, while steps 1–2 use env-only `_herdr_agent_get_scoped`. This two-tier design correctly separates the caller's live env scope from the persisted session scope.
|
||||
- Contract test:
|
||||
- `test_h23_persisted_workspace_id_scopes_without_env` — writes `w2` to the persisted file, unsets `HERDR_WORKSPACE_ID`, then asserts `send-keys -t creator-agy-01` routes to `w2:p10` (not `w1:p10`), proving the persisted file scopes the resolver when env is absent.
|
||||
- `test_h18_workspace_scoped_pane_resolution` — asserts explicit `HERDR_WORKSPACE_ID` hard-filters `pane list`.
|
||||
- `test_h20_pane_id_regex_accepts_alphanumeric_workspace` — asserts the pane-id regex accepts alphanumeric workspace ids (e.g. `w1E:p1`).
|
||||
|
||||
**Verdict**: ✅ Workspace session isolation fully implemented and verified. Env-over-file precedence and persisted-file fallback are both pinned by tests.
|
||||
|
||||
---
|
||||
|
||||
## 4. Test Execution Results
|
||||
|
||||
### 4.1 Targeted Tests (foreground)
|
||||
|
||||
```
|
||||
$ .venv/bin/python -m pytest tests/test_herdr_shim_contract.py tests/test_b19_headless_reconcile_fixes.py -q
|
||||
30 passed
|
||||
```
|
||||
|
||||
Both files most relevant to this changeset pass in full.
|
||||
|
||||
### 4.2 Full Suite (background)
|
||||
|
||||
```
|
||||
$ .venv/bin/python -m pytest -q (log: /tmp/pytest_7e4b6f26.log)
|
||||
........................................................................ [ 17%]
|
||||
........................................................................ [ 34%]
|
||||
........................................................................ [ 52%]
|
||||
........................................................................ [ 69%]
|
||||
........................................................................ [ 87%]
|
||||
.................................................... [100%]
|
||||
412 passed in 681.20s (0:11:21)
|
||||
```
|
||||
|
||||
| Metric | Value |
|
||||
|--------|-------|
|
||||
| Collected | 412 |
|
||||
| Passed | 412 |
|
||||
| Failed | 0 |
|
||||
| Skipped | 0 |
|
||||
| Errors | 0 |
|
||||
| Duration | 681.20s |
|
||||
|
||||
**DoD target (412 passed, 100%) — MET.**
|
||||
|
||||
### 4.3 Static Checks
|
||||
|
||||
```
|
||||
$ bash -n .agents/skills/lib.sh → OK (exit 0)
|
||||
$ .venv/bin/python -m pytest --collect-only -q | tail -1
|
||||
412 tests collected in 0.05s
|
||||
```
|
||||
|
||||
Syntax check passes; collection count matches the target.
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 5. Cross-Review Observations
|
||||
|
||||
### 5.1 Lint / Syntax
|
||||
- `bash -n` passes on both `lib.sh` and the generated shim (asserted by H-19 and run manually).
|
||||
- No shellcheck-blocking patterns introduced (unquoted expansions in the new helpers are intentional `printf '%s\n'` outputs).
|
||||
- Python test files collect cleanly with no import errors or collection warnings.
|
||||
|
||||
### 5.2 Behavioural Correctness
|
||||
- **Strict matching (ISSUE-2)**: `test_no_substring_matching_remains_in_lib_sh` and `test_h17_no_substring_cross_pane_routing` confirm no `agent in tn` substring matching remains anywhere in the shim. The resolver uses exact `agent get` equality, not substring.
|
||||
- **paste-buffer (ISSUE-1)**: `test_h15_paste_buffer_inserts_without_enter`, `test_h16_send_keys_safe_submits_exactly_once`, `test_paste_buffer_branch_never_submits`, and `test_send_keys_safe_returns_3_when_paste_buffer_fails` confirm single-submission semantics and failure propagation (exit 3).
|
||||
- **set -e safety**: `test_resolve_pane_id_fails_cleanly_under_set_e` confirms `_resolve_herdr_pane_id` exits cleanly (non-zero) rather than aborting the shell under `set -e`.
|
||||
|
||||
### 5.3 Loss / Regression Check
|
||||
- The changeset is additive in tests (+356 in the contract file, +107 in the b19 file) and refactoring in `lib.sh` (+289/−92 net). No previously-passing test was deleted or weakened.
|
||||
- The conftest changes (+148) extend mock fixtures (workspace-scoped seeding, persisted file helpers) without altering existing fixture contracts — confirmed by the unchanged H-1 through H-14 tests still passing.
|
||||
- No production files outside `.agents/skills/lib.sh` were touched.
|
||||
|
||||
---
|
||||
|
||||
## 6. Risk Assessment
|
||||
|
||||
| Risk | Likelihood | Mitigation |
|
||||
|------|-----------|-----------|
|
||||
| Cross-workspace routing via stale persisted file | Low | Env-over-file precedence; H-23 pins persisted-only path; unset env + absent file = global (H-21) |
|
||||
| F-4 fallback regression on future refactor | Low | H-19 asserts `_resolve_herdr_pane_id` presence in capture-pane arm |
|
||||
| `Yes, try it` false-positive reintroduced | Low | Five F-1 regression tests + token-set exclusion assertion |
|
||||
| Full-suite runtime growth (~11 min) | Informational | No action needed; tests are correct and deterministic |
|
||||
|
||||
No blocking risks identified. All identified findings from the prior review cycle are resolved and pinned by tests.
|
||||
|
||||
---
|
||||
|
||||
## 7. Conclusion
|
||||
|
||||
All five DoD criteria for job `7e4b6f26` are satisfied:
|
||||
|
||||
1. **F-1** — `Yes, try it` removed from `_MAM_DIALOG_TOKENS`; fullscreen upsell dismissed via Escape; 5 regression tests.
|
||||
2. **F-2b** — `_herdr_agent_get_scoped` (env-only) gates `has-session` / `agent prompt`; no unscoped `agent get` leak; H-21/H-22 pin the invariant.
|
||||
3. **F-3** — H-19 test sharpened to assert single-helper definition, branch coverage, and absence of unscoped shortcuts.
|
||||
4. **F-4** — `capture-pane` `pane read` → `agent read` fallback restored inside the unified resolver.
|
||||
5. **Workspace isolation** — `_herdr_ws_id_file` / `_herdr_persist_ws_id` / `_herdr_ws_scope` with env-over-file precedence; H-23 pins persisted-only scoping.
|
||||
|
||||
**Full pytest suite: 412 passed, 0 failed, 0 skipped.** Static checks (`bash -n`, collection) pass. No regressions, no orphaned code, no scope creep beyond the brief.
|
||||
|
||||
This changeset is approved for merge.
|
||||
|
||||
[VERDICT: PASS]
|
||||
Reference in New Issue
Block a user