#!/usr/bin/env bash
# test_adapter_lanes.sh — `scripts/adapters/*` (크로스하네스 **어댑터**)의 회귀 레인.
#
# ─────────────────────────────────────────────────────────────────────────────
# 무엇을 고정하나
# ─────────────────────────────────────────────────────────────────────────────
# 등록 바(`capability_registry_check.sh`)는 **선언된 캘리브레이션 arm 두 개만** 돌리고,
# 자기 출력에 «나머지 enum 값은 관측하지 않았다» 고 적는다. 어댑터에서 그 «나머지» 는
# 하필 가장 중요한 값이다 — **`PEER_ABSENT`**. 「그 하네스를 이 머신에 안 깔았다」가
# `CLEAN` 으로 접히면 미측정이 통과로 렌더되고, `HARNESS_ERROR` 로 접히면 멀쩡한 이웃이
# 고장으로 렌더된다. 이 레인 묶음이 그 값과 peer 해석 규칙을 고정한다.
#
# 레인 클래스 (되돌림 프로브가 이 태그로 «어느 레인이 빨개져야 하는가» 를 사전등록한다)
#   resolve-absent   peer 가 안 보일 때 **전용 값**이 나오는가
#   resolve-alias    별칭 규칙(`<n>-dev` · `_`→`-`)이 실제로 도는가
#   resolve-guard    모호/부분일치를 **고르지 않는가**
#   control          peer 가 보이면 **실제 판정**이 나오는가
#                    (「늘 PEER_ABSENT 를 찍는 계기」와 구분하는 자리)
#   enum             M4 가 관측하지 않는 나머지 enum 값들
#
# 사용법
#   bash scripts/test_adapter_lanes.sh                 # 레인 전부
#   bash scripts/test_adapter_lanes.sh --revert-probe  # 레인 + 되돌림 프로브 2종
# exit: 0 = 전부 기대대로 · 1 = 회귀 · 10 = 하네스 오류(전제 파손 — 판정 아님)

set -uo pipefail

REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# 되돌림 프로브가 **중화된 사본**을 가리키게 하려고 파라미터화한다. 기본값은 실물이다.
ADAPTER_DIR="${FH_ADAPTER_DIR:-$REPO_ROOT/scripts/adapters}"

T="$(mktemp -d)" || { echo "❌ HARNESS-ERROR — mktemp 실패"; exit 10; }
trap 'rm -rf "$T"' EXIT

FAIL=0; N=0
RED_LANES=""     # 이번 실행에서 빨개진 레인 ID (되돌림 프로브가 읽는다)

# ── peer 가 이 머신에 **있어야만** 의미가 있는 레인 ──────────────────────────
#   🟥 실측(2026-08-16): 로컬 23/23 초록인데 **CI 는 9레인 적색**이었다(G2 G3 G6 G9 M2 M3
#   Q2 Q3 Q6). 이 레인들이 루트 오버라이드 없이 어댑터를 불러 `$HOME/projects` 를 보는데,
#   CI 체크아웃엔 peer 레포가 없어 전부 `PEER_ABSENT(20)` 이 나왔다. 즉 레인의 앵커가
#   **운영자 머신의 레이아웃**에 걸려 있었다 — 같은 날 `L13c` 가 gitignored 데이터에 앵커를
#   걸어 CI 만 빨갛던 것과 **같은 클래스**다([[feedback_ci_measures_state_not_transition]]).
#
#   🟥 그리고 이 스킵은 **조용하면 안 된다.** peer 가 없는 환경에서 컨트롤이 전부 빠지면
#   남는 것은 PEER_ABSENT 레인뿐이고, 그건 「늘 PEER_ABSENT 를 내는 계기」와 **구분되지 않는다**
#   — 컨트롤이 막으려던 바로 그 상태다. 그래서 스킵 수를 세어 **종결 줄에 반드시 찍는다.**
SKIPPED=0
_lane_peer() {  # $1=peer_root $2=id $3=class $4=설명 $5=expected $6=actual
  if [ -n "$1" ]; then
    _lane "$2" "$3" "$4" "$5" "$6"
  else
    SKIPPED=$((SKIPPED + 1))
    printf '  ⏭  %-6s [%-14s] %s — peer 부재로 SKIP (**통과 아님**)\n' "$2" "$3" "$4"
  fi
}

_lane() {   # $1=id $2=class $3=설명 $4=expected_rc $5=actual_rc
  N=$((N + 1))
  if [ "$4" = "$5" ]; then
    printf '  ✅ %-6s [%-14s] %s (rc=%s)\n' "$1" "$2" "$3" "$5"
  else
    printf '  ❌ %-6s [%-14s] %s — expect rc=%s, got rc=%s\n' "$1" "$2" "$3" "$4" "$5"
    FAIL=1; RED_LANES="$RED_LANES $1"
  fi
}

# 계기 전제 — 어댑터 3종이 **실제로 거기 있는지** 먼저 본다. 없으면 이 레인 묶음은
# «전부 초록» 이 아니라 하네스 오류다(빈 대상에 대고 초록을 내는 것이 여기서 막으려는 형태).
for a in gstack_content_safety mate_agent_boundary qasp_new_code_anchor qasp_web_rules peer_resolve; do
  [ -r "$ADAPTER_DIR/$a.sh" ] || { echo "❌ HARNESS-ERROR — $ADAPTER_DIR/$a.sh 부재. 빈 대상에 초록을 내지 않는다"; exit 10; }
done

G="$ADAPTER_DIR/gstack_content_safety.sh"
M="$ADAPTER_DIR/mate_agent_boundary.sh"
Q="$ADAPTER_DIR/qasp_new_code_anchor.sh"
W="$ADAPTER_DIR/qasp_web_rules.sh"

# 「peer 가 안 보이는 세계」 = 잘 형성된 루트 목록인데 그 안에 이 peer 가 없는 것.
# (빈 **문자열**이 아니다 — 그건 「어디를 볼지 자체가 없다」는 다른 명제이고 전제 파손이다.)
EMPTY_WORLD="$T/empty_world"; mkdir -p "$EMPTY_WORLD"

# 🟥 **상속된 `FH_CLUSTER_ROOTS` 를 여기서 끊는다 — pmh-dev #80 ⓑ 제보 (2026-09-14).**
#    `fh_peer_resolve` 는 `FH_CLUSTER_ROOTS` 가 있으면 **그것이 전부**다(다른 팔을 안 본다).
#    그래서 운영자가 그 변수를 export 해 두면 픽스처 세계를 지어 놓고도 레인이 **실물 머신**을
#    읽는다. 계기가 자기 대상 대신 저자의 환경을 재는 형태다.
#    🟥 실측(이 레포, 같은 날): pin 을 export 한 채 돌리면 **레인 9개가 빨개진다**
#    (M2 M3 M2b M2c M5 M6 P1 P2 P3) — 회귀가 아니라 **환경 누수**인데 같은 빨강으로 읽힌다.
#    PMH 는 4건으로 봤고 실제로는 더 넓었다.
#    ⇒ 여기서 한 번 끊고, **필요한 레인은 호출 시점에 인라인으로 다시 준다**(이미 그렇게 쓰고 있다:
#      `FH_CLUSTER_ROOTS="$GS_ROOT" _rc bash …`). 값을 «비우는» 게 아니라 **unset** 이다 —
#      빈 문자열은 「어디를 볼지 자체가 없다」는 다른 명제라 전제 파손으로 읽힌다.
if [ -n "${FH_CLUSTER_ROOTS:-}" ]; then
  printf '  ℹ️  상속된 FH_CLUSTER_ROOTS 를 끊는다(픽스처 격리) — 원래 값: %s\n' "$FH_CLUSTER_ROOTS"
fi
unset FH_CLUSTER_ROOTS

_rc() { "$@" >/dev/null 2>&1; printf '%s' "$?"; }   # 판정은 파이프를 통과시키지 않는다

# 실물 peer 루트 — 있으면 alias/control 레인을 돌리고, 없으면 그 레인은 SKIP 으로 **말한다**.
PEER_HOME="${FH_PROJECTS_HOME:-$HOME/projects}"
_peer_root() {  # $1=이름 → 실물 루트 or 빈 문자열 (별칭 순서는 어댑터와 같다)
  local n="$1" c
  for c in "$n" "$n-dev" "$(printf '%s' "$n" | tr '_' '-')"; do
    [ -d "$PEER_HOME/$c" ] && { printf '%s' "$PEER_HOME/$c"; return; }
  done
  printf ''
}
GS_ROOT="$(_peer_root gstack)"; MT_ROOT="$(_peer_root mate)"; QS_ROOT="$(_peer_root qasp)"

echo "== 어댑터 레인 (대상: $ADAPTER_DIR) =="
echo

# ═══════════════════════════════════════════════════════════════════════════
# ① gstack-content-safety
# ═══════════════════════════════════════════════════════════════════════════
echo "── gstack-content-safety (enum 0=CLEAN 1=BLOCK_HIGH 2=REVIEW_MEDIUM 3=NO_TARGET 10=HARNESS_ERROR 20=PEER_ABSENT)"
_lane G1 resolve-absent "peer 불가시 → 전용값 PEER_ABSENT(CLEAN 도 HARNESS_ERROR 도 아니다)" 20 \
  "$(FH_CLUSTER_ROOTS="$EMPTY_WORLD" _rc bash "$G" --known-positive)"
_lane_peer "$GS_ROOT" G2 control "peer 가시 → 실제 판정 BLOCK_HIGH («늘 PEER_ABSENT» 와 구분)" 1 \
  "$(_rc bash "$G" --known-positive)"
_lane_peer "$GS_ROOT" G3 control "peer 가시 → 음성 arm 은 CLEAN (계기가 «가른다» 는 증거)" 0 \
  "$(_rc bash "$G" --known-negative)"
if [ -n "$GS_ROOT" ]; then
  _lane G4 resolve-alias "명시 루트 목록(FH_CLUSTER_ROOTS)으로 해석된다" 0 \
    "$(FH_CLUSTER_ROOTS="$GS_ROOT" _rc bash "$G" --known-negative)"
else
  echo "  ⏭  G4    [resolve-alias ] gstack 실물 루트 없음 — SKIP (통과 아님)"
fi
# 부분일치로 남의 레포를 집지 않는다. basename 이 **정확히** 별칭 후보여야 한다.
mkdir -p "$T/world_prefix/gstackx"
_lane G5 resolve-guard "basename 부분일치는 peer 가 아니다(gstackx ≠ gstack)" 20 \
  "$(FH_CLUSTER_ROOTS="$T/world_prefix/gstackx" _rc bash "$G" --known-positive)"
mkdir -p "$T/empty_target"
_lane_peer "$GS_ROOT" G6 enum "빈 디렉토리 → NO_TARGET(3). CLEAN 이 아니다 — 아무것도 안 쟀다" 3 \
  "$(_rc bash "$G" --target "$T/empty_target")"
_lane_peer "$GS_ROOT" G7 enum "없는 대상 → HARNESS_ERROR(10). 부재 대상은 빈 대상이 아니다" 10 \
  "$(_rc bash "$G" --target "$T/does_not_exist")"
_lane_peer "$GS_ROOT" G8 enum "인자 없음 → HARNESS_ERROR(10). 안 돈 실행을 판정으로 렌더하지 않는다" 10 \
  "$(_rc bash "$G")"
# MEDIUM 만 — 자동 차단이 아니라 사람 판단. 리터럴은 이 소스가 자기 스캐너에 물리지 않게 쪼갠다.
printf 'payroll note\ncontact ssn %s-%s-%s for the record\n' '123' '45' '6789' > "$T/medium_only.txt"
_lane_peer "$GS_ROOT" G9 enum "MEDIUM 만 → REVIEW_MEDIUM(2). CLEAN 과도 BLOCK 과도 다른 값이다" 2 \
  "$(_rc bash "$G" --target "$T/medium_only.txt")"
echo

# ═══════════════════════════════════════════════════════════════════════════
# ② mate-agent-boundary
# ═══════════════════════════════════════════════════════════════════════════
echo "── mate-agent-boundary (enum 0=PASS 1=FAIL 10=HARNESS_ERROR 20=PEER_ABSENT)"
_lane M1 resolve-absent "peer 불가시 → 전용값 PEER_ABSENT(PASS 로도 HARNESS_ERROR 로도 안 접힌다)" 20 \
  "$(FH_CLUSTER_ROOTS="$EMPTY_WORLD" _rc bash "$M" --known-positive)"
_lane_peer "$MT_ROOT" M2 control "peer 가시 → 실제 판정 PASS" 0 "$(_rc bash "$M" --known-positive)"
_lane_peer "$MT_ROOT" M3 control "peer 가시 → 음성 arm 은 FAIL (판별력의 증거)" 1 "$(_rc bash "$M" --known-negative)"
if [ -n "$MT_ROOT" ]; then
  # 🟥 별칭 레인의 핵심: 이름은 `mate` 인데 실물 디렉토리는 `mate-dev` 다.
  #    별칭 후보에서 `<n>-dev` 가 빠지면 이 레인이 즉시 PEER_ABSENT 로 빨개진다.
  _lane M4 resolve-alias "이름 mate → 실물 $(basename "$MT_ROOT") 로 별칭 해석된다" 0 \
    "$(FH_CLUSTER_ROOTS="$MT_ROOT" _rc bash "$M" --known-positive)"
else
  echo "  ⏭  M4    [resolve-alias ] mate 실물 루트 없음 — SKIP (통과 아님)"
fi
# 🟥 M2b/M2c — **대상 인자가 실제로 먹히는가** (2026-08-18 신설).
#    초판은 대상을 peer 진입점에 `$1` 로 넘겼는데 **peer 는 그 인자를 안 읽는다**
#    (`TARGET` 하드코딩). 그래서 양성·음성 두 arm 이 **같은 파일**(peer 실물)을 재고 있었고,
#    음성의 초록은 판별력이 아니라 **실물이 마침 실패 상태**여서였다 — 캘리브레이션 쌍이
#    죽어 있었다. M2/M3 만으로는 그 상태를 못 가른다(둘 다 «기대대로» 나올 수 있다).
#    ⇒ **픽스처를 변형해 판정이 따라오는지**를 본다. peer 실물 상태와 무관하게 성립한다.
if [ -n "$MT_ROOT" ]; then
  _MUT="$T/mutated_positive.md"
  # 양성 픽스처에서 T11(finding_id 어휘 제약) 한 줄만 뺀다.
  grep -v '\^\[a-f0-9\]{6,64}\$' "$(dirname "$M")/fixtures/mate_agent_boundary_known_positive.md" >"$_MUT"
  _lane M2b target-honored "양성에서 한 조항만 빼면 → FAIL (대상 인자가 실제로 먹힌다)" 1 \
    "$(_rc bash "$M" --target "$_MUT")"
  _lane M2c target-honored "원본 양성은 그대로 PASS (변형 레인의 컨트롤)" 0 \
    "$(_rc bash "$M" --known-positive)"
else
  echo "  ⏭  M2b/M2c [target-honored] mate 실물 루트 없음 — SKIP (통과 아님)"
fi
_lane_peer "$MT_ROOT" M5 enum "없는 대상 → HARNESS_ERROR(10). peer 헤더가 «위반 0 이 아니다» 라고 못 박은 값" 10 \
  "$(_rc bash "$M" --target "$T/does_not_exist.md")"
_lane_peer "$MT_ROOT" M6 enum "알 수 없는 모드 → HARNESS_ERROR(10)" 10 "$(_rc bash "$M" --bogus-mode)"
echo

# ═══════════════════════════════════════════════════════════════════════════
# ③ qasp-new-code-anchor
# ═══════════════════════════════════════════════════════════════════════════
echo "── qasp-new-code-anchor (enum 0=PASS 1=VIOLATION 2=ARGS 3=HARNESS_ERROR 4=OUT_OF_SCOPE 20=PEER_ABSENT)"
_lane Q1 resolve-absent "peer 불가시 → 전용값 PEER_ABSENT(PASS 로도 HARNESS_ERROR 로도 안 접힌다)" 20 \
  "$(FH_CLUSTER_ROOTS="$EMPTY_WORLD" _rc bash "$Q" --known-positive)"
_lane_peer "$QS_ROOT" Q2 control "peer 가시 → 실제 판정 VIOLATION" 1 "$(_rc bash "$Q" --known-positive)"
_lane_peer "$QS_ROOT" Q3 control "peer 가시 → 음성 arm 은 PASS (판별력의 증거)" 0 "$(_rc bash "$Q" --known-negative)"
if [ -n "$QS_ROOT" ]; then
  _lane Q4 resolve-alias "이름 qasp → 실물 $(basename "$QS_ROOT") 로 별칭 해석된다" 0 \
    "$(FH_CLUSTER_ROOTS="$QS_ROOT" _rc bash "$Q" --known-negative)"
  # 🟥 모호 가드 — 한 이름에 레포 둘. **고르지 않는다.** 조용히 하나를 고르면 «어느
  #    하네스를 쟀는지» 아무도 모르게 된다. 판정 불가는 PASS 가 아니므로 HARNESS_ERROR.
  mkdir -p "$T/ambig/qasp" "$T/ambig/qasp-dev"
  _lane Q5 resolve-guard "한 이름에 레포 둘 → 고르지 않고 HARNESS_ERROR(3)" 3 \
    "$(FH_CLUSTER_ROOTS="$T/ambig/qasp:$T/ambig/qasp-dev" _rc bash "$Q" --known-positive)"
else
  echo "  ⏭  Q4/Q5 [resolve-*    ] qasp 실물 루트 없음 — SKIP (통과 아님)"
fi
_lane_peer "$QS_ROOT" Q6 enum "--range 에 base 없음 → ARGS(2). 판정이 아니다" 2 "$(_rc bash "$Q" --range)"

# ── 합성 peer — peer 히스토리를 만지지 않고 나머지 enum 을 덮는다 ────────────
# 🟥 왜 합성 peer 인가: peer 는 `residency: company` 다. 실물 히스토리를 레인으로 쓰면
#    레인 출력에 조직 경로가 실린다. 그리고 실물 히스토리는 남의 커밋에 따라 조용히
#    다른 것을 재게 된다(감사 대상은 얼려야 한다). 합성 peer 는 **peer 의 실제 진입점
#    스크립트를 복사해** 쓰므로, 재는 것은 여전히 «어댑터가 peer 의 exit 을 옳게
#    재매핑하는가» 다 — 어댑터의 매핑이지 peer 의 히스토리가 아니다.
if [ -n "$QS_ROOT" ] && [ -r "$QS_ROOT/scripts/new_code_anchor_scan.sh" ]; then
  SYN="$T/synworld/qasp-dev"; mkdir -p "$SYN/scripts" "$SYN/src" "$SYN/tests"
  cp "$QS_ROOT/scripts/new_code_anchor_scan.sh" "$SYN/scripts/" || { echo "❌ HARNESS-ERROR — peer 진입점 복사 실패"; exit 10; }
  GIT=(git -c user.email=lane@localhost -c user.name=lane -c commit.gpgsign=false)
  ( cd "$SYN" && "${GIT[@]}" init -q . && printf 'base\n' > README.md \
      && "${GIT[@]}" add -A && "${GIT[@]}" commit -qm base ) >/dev/null 2>&1 \
    || { echo "❌ HARNESS-ERROR — 합성 peer 레포 생성 실패"; exit 10; }
  SYN_BASE="$(cd "$SYN" && git rev-parse HEAD)"
  # 범위 밖 언어의 신규 실행 코드만 넣는다 → 「검사되지 않았다」 ≠ 「깨끗하다」
  ( cd "$SYN" && printf 'export const f = (a) => a + 1;\n' > src/newthing.ts \
      && "${GIT[@]}" add -A && "${GIT[@]}" commit -qm oos ) >/dev/null 2>&1
  _lane Q7 enum "범위 밖 언어의 신규 실행 코드 → OUT_OF_SCOPE(4). PASS 로 접히지 않는다" 4 \
    "$(FH_CLUSTER_ROOTS="$SYN" _rc bash "$Q" --range "$SYN_BASE" HEAD)"
  _lane Q8 enum "해석 불가 ref → HARNESS_ERROR(3). 판정이 아니다" 3 \
    "$(FH_CLUSTER_ROOTS="$SYN" _rc bash "$Q" --range no-such-ref-xyz HEAD)"
else
  echo "  ⏭  Q7/Q8 [enum         ] qasp 진입점 도달 불가 — SKIP (통과 아님)"
fi
echo

# ═══════════════════════════════════════════════════════════════════════════
# ④ qasp-web-rules  (자매 노드 — 같은 peer, 다른 능력)
# ═══════════════════════════════════════════════════════════════════════════
# 🟥 ③ 과 **같은 peer 인데 다른 enum 이다**. 값을 옮겨 쓰면 안 된다 —
#    ③ 의 `3=HARNESS_ERROR`·`4=OUT_OF_SCOPE` 와 여기의 `3=ENGINE_ERROR` 는 다른 사건이고,
#    여기엔 `4` 가 아예 없다. 두 노드를 한 눈에 보는 이 파일이 그 혼동의 1순위 발생지다.
echo "── qasp-web-rules (enum 0=CLEAN 1=FINDINGS 2=ARGS 3=ENGINE_ERROR 20=PEER_ABSENT)"
_lane W1 resolve-absent "peer 불가시 → 전용값 PEER_ABSENT(CLEAN 으로도 ENGINE_ERROR 로도 안 접힌다)" 20 \
  "$(FH_CLUSTER_ROOTS="$EMPTY_WORLD" _rc bash "$W" --known-positive)"
_lane_peer "$QS_ROOT" W2 control "peer 가시 → 양성 arm 은 FINDINGS" 1 "$(_rc bash "$W" --known-positive)"
_lane_peer "$QS_ROOT" W3 control "peer 가시 → 음성 arm 은 CLEAN (판별력의 증거)" 0 "$(_rc bash "$W" --known-negative)"
_lane W4 enum "모드 미지정 → ARGS(2). 안 돈 실행을 판정으로 렌더하지 않는다" 2 "$(_rc bash "$W")"
_lane W5 enum "없는 diff-json → ARGS(2). 호출 오류지 계기 고장이 아니다" 2 \
  "$(_rc bash "$W" --diff-json /nonexistent/nope.json)"
# 🟥 W6 — 픽스처 부재는 **ARGS 가 아니라 HARNESS_ERROR** 다. 캘리브레이션 쌍이 사라진 것은
#    「호출을 잘못했다」가 아니라 **「이 계기가 자기 판별력을 증명할 수 없다」**는 뜻이고,
#    그 둘을 같은 값으로 접으면 «쌍이 없는 계기»가 «인자 실수»로 보고된다.
if [ -n "$QS_ROOT" ]; then
  FIXBK="$T/fixbk"; mkdir -p "$FIXBK"
  FIXPOS="$ADAPTER_DIR/fixtures/qasp_web_rules_known_positive.json"
  if [ -r "$FIXPOS" ]; then
    mv "$FIXPOS" "$FIXBK/pos.json"
    _lane W6 enum "캘리브레이션 픽스처 부재 → HARNESS_ERROR(10), ARGS 아님" 10 \
      "$(_rc bash "$W" --known-positive)"
    mv "$FIXBK/pos.json" "$FIXPOS"
    # 복원 확인 — 레인이 자기가 옮긴 것을 되돌렸는지 **잰다**(안 하면 다음 레인이 거짓 적색)
    [ -r "$FIXPOS" ] || { echo "❌ HARNESS-ERROR — W6 가 픽스처를 복원하지 못했다"; exit 10; }
  else
    echo "  ⏭  W6     [enum         ] 양성 픽스처 부재 — SKIP (통과 아님)"
  fi
else
  echo "  ⏭  W6     [enum         ] qasp 실물 루트 없음 — SKIP (통과 아님)"
fi
echo

# ═══════════════════════════════════════════════════════════════════════════
# 되돌림 프로브 — 앵커가 장식이 아님을 «되돌려 보고» 잰다 (적용확인 → 실행 → 복원)
# ═══════════════════════════════════════════════════════════════════════════
# 레인이 초록인 것과 레인에 **판별력이 있는 것**은 다른 명제다. 여기서는 peer 해석부를
# 두 방향으로 중화하고, **사전등록한 레인 집합만** 빨개지는지 본다.
#   R1 «부재 분기» 중화 → 부재를 부재로 못 낸다  ⇒ resolve-absent + resolve-guard(부분일치) 빨강
#   R2 «별칭 목록» 중화 → `-dev` 를 못 찾는다    ⇒ mate/qasp 의 alias·control·enum 레인만 빨강
#
# 🟥 **초판 사전등록이 두 군데 틀렸고, 프로브가 그걸 잡았다**(2026-08-16). 적어 두는 이유는
#    이게 프로브에 판별력이 있다는 증거이기 때문이다 — 사전등록을 관측에 맞춰 조용히 고치면
#    그 증거가 사라진다. 두 차이는 **레인 결함이 아니라 사전등록 오류**였고, 기계적으로 설명된다:
#      · R1 에 **G5** 가 추가로 빨강: G5 는 `gstackx` 루트를 준다. 중화판은 부재 분기 대신
#        `$PROJECTS_HOME/gstack` 를 내는데 **그 경로는 실재한다** → 어댑터가 실제로 돌아
#        BLOCK_HIGH(1) 을 낸다. G5 도 부재 분기에 결박된 레인이므로 빨강이 맞다.
#      · R2 에서 **Q5 는 초록**: Q5 는 `qasp` 와 `qasp-dev` 둘을 주는 모호 레인이다. 별칭
#        목록이 `$1` 하나로 줄면 `qasp` 만 맞아 **모호가 아니게 되고**, 어댑터는 진입점
#        부재로 HARNESS_ERROR(3) 를 낸다 — 기대값과 같은 값이다. 즉 R2 는 Q5 를 원리적으로
#        구분하지 못한다. 그건 Q5 의 결함이 아니라 **이 프로브 축의 사각지대**이고,
#        Q5 는 R1 이 아니라 별도 축(모호 판정 자체를 지우는 중화)으로만 흔들 수 있다.
# ── P 레인: peer_resolve 자체의 이름 해석 (2026-08-21 신설) ─────────────────────
# 🟥 이게 왜 필요한가: `peer_resolve.sh` 의 `FH_PROJECTS_HOME` 팔을 `fh_track_resolve.sh` 로
#    배선하면서 **거짓 AMBIGUOUS 결함이 하나 닫혔는데, 그 변경을 되돌려도 빨개지는 레인이
#    0개였다**(실측). 즉 기존 31 레인은 이 축에 대해 앵커가 아니다 —
#    [[feedback_anchor_can_be_decorative]]. 픽스처는 **실제로 뚫려 있던 표기**(공백 이름)를 쓴다.
#
# 🟥 **초판 P 레인은 거짓 초록이었다 — 계기가 대상을 안 불렀다.** `peer_resolve.sh` 를
#    `bash <파일> <이름>` 으로 «실행» 했는데 이 파일은 **sourced 라이브러리**라 실행하면
#    아무것도 안 하고 rc=0 으로 끝난다. P1·P3 이 그 rc=0 을 «해소 성공» 으로 읽어 초록이었고,
#    P2 의 빨강도 코드 결함이 아니라 내 하네스 결함이었다. 판별 근거는 **HEAD 에서도 같은
#    값이 나왔다**는 것이다(변경 전후가 같으면 계기가 대상을 안 보고 있다).
#    [[feedback_instrument_vs_target_and_budget]] — 이상하면 대상보다 계기를 먼저 의심해라.
_PR="${FH_ADAPTER_DIR:-$REPO_ROOT/scripts/adapters}/peer_resolve.sh"
if [ ! -f "$_PR" ]; then
  echo "  SKIP P 레인 (peer_resolve.sh 없음) — PASS 가 아니라 미검사다"
else
  # shellcheck source=scripts/adapters/peer_resolve.sh
  . "$_PR"
  if ! type fh_peer_resolve >/dev/null 2>&1; then
    echo "  ❌ P 레인 하네스 결함 — source 했는데 fh_peer_resolve 가 없다"
    FAIL=1
  else
  _PW="$(mktemp -d)"
  mkdir -p "$_PW/sp ace" "$_PW/aliased-dev" "$_PW/dual" "$_PW/dual-dev"
  # 🟥 2026-09-14 (pmh-dev #80 B안 «exact match wins»): `dual` 은 이제 **정확 일치라 이긴다** —
  #    그래서 그걸로 «모호 검출이 살아 있나» 를 물으면 컨트롤이 대상과 같이 죽는다.
  #    진짜 모호는 **정확 일치가 없는** 자리다: my_repo(없음) · my_repo-dev · my-repo.
  mkdir -p "$_PW/my_repo-dev" "$_PW/my-repo"
  # P0 컨트롤 — 계기가 대상을 실제로 부르는가. 이게 초록이 아니면 아래 셋은 의미가 없다.
  FH_PROJECTS_HOME="$_PW" fh_peer_resolve nosuchpeer >/dev/null 2>&1; _prc=$?
  _lane P0 control "계기 생존 — 없는 peer 는 부재(1)로 온다(rc=0 무음이면 대상을 안 부른 것)" 1 "$_prc"
  # P1 — 공백 이름 1건: 한 후보가 두 단어로 세어져 거짓 AMBIGUOUS(2) 가 나던 자리
  FH_PROJECTS_HOME="$_PW" fh_peer_resolve 'sp ace' >/dev/null 2>&1; _prc=$?
  _lane P1 resolve-guard "공백 이름 1건은 정상 해소 — 거짓 AMBIGUOUS 아님" 0 "$_prc"
  # P2 컨트롤 — 진짜 모호는 여전히 거부해야 한다(P1 의 통과가 모호검출을 죽인 게 아니다)
  FH_PROJECTS_HOME="$_PW" fh_peer_resolve my_repo >/dev/null 2>&1; _prc=$?
  _lane P2 control "진짜 모호(정확 일치 없음: my_repo-dev + my-repo)는 여전히 고르지 않는다" 2 "$_prc"
  # P2-b (신규) — 정확 일치가 있으면 별칭이 같이 있어도 이긴다. 제보 증상 그 자체
  #    (한 노드에 ~/projects/<name> + ~/projects/<name>-dev 공존 → 종전엔 AMBIGUOUS → M2/M3 가 HARNESS_ERROR)
  FH_PROJECTS_HOME="$_PW" fh_peer_resolve dual >/dev/null 2>&1; _prc=$?
  _lane P2b resolve-exact "exact match wins — dual+dual-dev 에서 dual 로 해소(제보 증상)" 0 "$_prc"
  # P3 컨트롤 — 별칭 해소가 실제로 살아 있나(P 레인이 통째로 공허하지 않다는 증거)
  FH_PROJECTS_HOME="$_PW" fh_peer_resolve aliased >/dev/null 2>&1; _prc=$?
  _lane P3 resolve-alias "'-dev' 별칭이 해소된다" 0 "$_prc"
  # ── P4·P5 — 파일 머리의 `unset FH_CLUSTER_ROOTS` 가 **장식이 아님**을 박는다 ──────────
  # 🟥 pmh-dev #80 ⓑ. `FH_CLUSTER_ROOTS` 가 있으면 그것이 **전부**이고 `FH_PROJECTS_HOME` 팔은
  #    아예 안 돈다. 그래서 운영자가 그 변수를 export 해 두면 픽스처 세계를 지어 놓고도 레인이
  #    실물 머신을 읽는다 — 실측 9개 적색(M2 M3 M2b M2c M5 M6 P1 P2 P3).
  #    아래 둘이 그 **기전**을 직접 잰다. 머리의 unset 을 지우면 이 둘이 무의미해지는 게 아니라,
  #    이 둘이 살아 있으므로 «왜 unset 이 필요한가» 가 기록으로 남는다.
  _DECOY="$(mktemp -d)"; mkdir -p "$_DECOY/aliased"   # 미끼 세계: 'aliased' 가 **정확히** 있다
  # P4 known-positive — 미끼가 켜져 있으면 픽스처 세계(aliased-dev)가 아니라 미끼가 이긴다
  _got="$(FH_CLUSTER_ROOTS="$_DECOY/aliased" FH_PROJECTS_HOME="$_PW" fh_peer_resolve aliased 2>/dev/null)"
  case "$_got" in
    "$_DECOY/aliased") _prc=0 ;;
    *)                 _prc=1 ;;
  esac
  _lane P4 env-dominance "FH_CLUSTER_ROOTS 가 있으면 FH_PROJECTS_HOME 팔을 **덮는다**(그래서 머리에서 unset 한다)" 0 "$_prc"
  # P5 컨트롤 — 미끼를 끄면 같은 호출이 픽스처 세계로 돌아온다(P4 가 항상-참이 아니다)
  _got="$(FH_PROJECTS_HOME="$_PW" fh_peer_resolve aliased 2>/dev/null)"
  case "$_got" in
    "$_PW/aliased-dev") _prc=0 ;;
    *)                  _prc=1 ;;
  esac
  _lane P5 control "미끼를 끄면 픽스처 세계로 돌아온다 — P4 가 항상-참이 아니다" 0 "$_prc"
  rm -rf "$_DECOY"
  rm -rf "$_PW"
  fi
fi
# 🟥 **명시 잔여 — 팔 A 는 안 닫혔다.** `FH_CLUSTER_ROOTS`(임의 절대경로의 basename 조회)는
#    조회 모델이 달라 라이브러리로 통일하지 않았고, 거기 공백 거짓-AMBIGUOUS 가 **그대로 있다**
#    (실측 확인). 별도 축의 독립 수리이므로 레인을 안 박았다 — 안 잰 것이지 통과한 게 아니다.

# 🟥 **2026-08-21 — 사전등록 두 줄을 갱신했다. 이유를 적는 게 갱신 자체보다 중요하다.**
#    (위 규율 그대로: 관측에 맞춰 «조용히» 고치면 프로브의 판별력 증거가 사라진다.)
#      · **R1: `G1 G5 M1 Q1` → `G1 G5 M1 Q1 W1`** — **선재 오류**다. 사전등록이 `qasp_web_rules.sh`
#        (W 레인) 도입 **이전**에 쓰였고, W1 도 부재 분기에 결박된 레인이라 빨간 게 맞다.
#        내 변경 이전 HEAD 에서도 `--revert-probe` 는 이 차이로 RC=1 이었다(실측). 즉 이건
#        내가 깬 게 아니라 **이미 틀려 있던 것을 이번에 갚는 것**이다.
#      · **R2: 11개 → `M4 Q4 Q7 Q8`** — 이건 **내 변경이 원인**이고, 기대값을 낮추는 것으로
#        끝내면 안 된다. `peer_resolve.sh` 의 `FH_PROJECTS_HOME` 팔이 이제 별칭을
#        `fh_track_resolve.sh` 에서 받으므로 **`fh_peer_alias_candidates` 를 안 읽는다** →
#        그걸 중화해도 안 흔들린다. 남은 넷은 전부 `FH_CLUSTER_ROOTS`(팔 A) 레인이다.
#        🟥 **명시 잔여 — 커버리지가 줄었다**: R2 는 더 이상 «팔 B 가 별칭을 보는가» 를
#        흔들지 못한다. 그 축의 앵커는 지금 `scripts/test_track_resolve_lanes.sh`(라이브러리
#        레인 1~3 + 배선 레인 9)에만 있고, **어댑터 층에는 없다.** 팔 A 는 조회 모델이 달라
#        (임의 절대경로의 basename) 통일하지 않았으므로 R2 는 그대로 유효하다.
#        이 잔여를 닫으려면 라이브러리를 중화하는 별도 프로브 축(R3)이 필요하고,
#        지금 프로브는 `scripts/adapters/` 만 사본으로 뜨므로 **그 축은 아직 없다.**
#      · **P 레인 추가분(같은 날, 2차)**: `P0 P1` 이 R1 에, `P1` 이 R2 에 들어간다. 사전등록을
#        P 레인 **추가 전에** 썼기 때문에 빠져 있었다. 기계적 설명: R1 은 부재 분기를 «순진한
#        추측» 으로 바꾸므로 P0(없는 peer → rc=1 이어야 한다)이 rc=0 을 받아 빨개지고, P1 도
#        그 조기 반환에 걸린다. R2 는 별칭 후보를 이름 하나로 줄이므로 P1(공백 이름 해소)이
#        후보 루프를 못 탄다. 🟥 **둘 다 «레인이 그 중화에 실제로 반응한다»는 뜻이라 빨간 게
#        맞다** — 이 갱신은 기대를 낮추는 게 아니라 **새 앵커를 사전등록에 등록하는 것**이다.
# ★중화는 **실물 파일이 아니라 사본**에 건다(FH_ADAPTER_DIR). 실물 트리를 건드리지 않고,
#  사본이 실물과 «중화한 줄 말고는 동일» 함을 적용확인 단계에서 대조한다.
_revert_probe() {
  local name="$1" sedexpr="$2" applied_marker="$3" expect_red="$4" desc="$5"
  local C="$T/neutralized_$name"
  rm -rf "$C"; mkdir -p "$C"
  cp -R "$REPO_ROOT/scripts/adapters/." "$C/" || { echo "❌ HARNESS-ERROR — 사본 생성 실패"; return 10; }
  # ── 1단 적용확인: 중화가 **실제로 들어갔는가**. 안 들어간 채 «초록» 을 보고
  #    «레인이 튼튼하다» 고 읽는 것이 이 프로브의 최대 실패모드다.
  sed -i.bak "$sedexpr" "$C/peer_resolve.sh" && rm -f "$C/peer_resolve.sh.bak"
  if ! grep -q "$applied_marker" "$C/peer_resolve.sh"; then
    echo "  ❌ $name — 중화가 적용되지 않았다(마커 «$applied_marker» 부재). 프로브를 신뢰할 수 없다"
    return 1
  fi
  # 중화한 파일 말고는 사본이 실물과 동일해야 한다(다른 변수를 안 건드렸다는 확인).
  local other_diff
  other_diff="$(diff -rq "$REPO_ROOT/scripts/adapters" "$C" 2>/dev/null | grep -v 'peer_resolve.sh' | wc -l | tr -d ' ')"
  if [ "$other_diff" != "0" ]; then
    echo "  ❌ $name — 사본이 peer_resolve.sh 외에도 다르다($other_diff건). 프로브 격리 실패"
    return 1
  fi
  # ── 2단 실행: 사본을 대상으로 레인을 통째로 다시 돌린다.
  local out red
  out="$(FH_ADAPTER_DIR="$C" bash "${BASH_SOURCE[0]}" --lanes-only 2>&1)"
  red="$(printf '%s\n' "$out" | sed -n 's/^  ❌ \([A-Z][0-9]*\) .*/\1/p' | sort | tr '\n' ' ' | sed 's/ $//')"
  # ── 3단 복원: 사본을 지운다. 실물은 애초에 안 건드렸다.
  rm -rf "$C"
  printf '  %s — %s\n' "$name" "$desc"
  printf '     사전등록 빨강: [%s]\n' "$expect_red"
  printf '     실측   빨강: [%s]\n' "$red"
  if [ "$red" = "$expect_red" ]; then
    printf '     ✅ 정확히 그 레인만 빨개졌다 — 이 레인들은 peer 해석부에 실제로 결박돼 있다\n'
    return 0
  fi
  printf '     ❌ 사전등록과 다르다 — 레인이 장식이거나 사전등록이 틀렸다. 둘 다 결함이다\n'
  return 1
}

case "${1:-}" in
  --lanes-only)
    # 되돌림 프로브가 자기를 재귀 호출할 때 쓰는 모드. 프로브를 다시 돌리지 않는다.
    ;;
  --revert-probe)
    echo "== 되돌림 프로브 (적용확인 → 실행 → 복원) =="
    RP=0
    # R1: 「없다」를 못 내게 한다 — 부재 분기를 순진한 추측 경로로 바꾼다.
    _revert_probe R1 \
      's|^    printf .peer-resolve: peer|    printf "%s" "${FH_PROJECTS_HOME:-$HOME/projects}/$n"; return 0  # NEUTRALIZED_R1\n    printf '"'"'peer-resolve: peer|' \
      'NEUTRALIZED_R1' \
      'G1 G5 M1 P0 P1 Q1 W1' \
      '«부재» 분기 중화 → 부재 분기에 결박된 레인만 빨개져야 한다' || RP=1
    echo
    # R2: 별칭 후보를 이름 자신 하나로 줄인다 — `-dev` 를 못 찾게 된다.
    _revert_probe R2 \
      's|^  printf .%s\\n. "\$1" "\$1-dev".*$|  printf "%s\\n" "$1"   # NEUTRALIZED_R2|' \
      'NEUTRALIZED_R2' \
      'M4 P1 Q4 Q7 Q8' \
      '별칭 목록 중화 → mate/qasp 쪽 레인만 빨개져야 한다(gstack 은 별칭이 필요 없다)' || RP=1
    echo
    [ "$RP" -eq 0 ] || FAIL=1
    ;;
  '') ;;
  *) echo "usage: $(basename "$0") [--revert-probe]" >&2; exit 10 ;;
esac

echo
if [ "$FAIL" -eq 0 ]; then
  # ★`${N}` 로 감싼다 — 한글이 바로 뒤에 오면 bash 가 `$N개` 를 **변수명 `N개`** 로 읽어
  #   `unbound variable` 로 죽는다(실측 2026-08-16: 레인 23개 전부 초록인데 마지막 요약
  #   줄에서 rc=1). 계기가 자기 보고 줄에서 죽으면 초록이 빨강으로 렌더된다.
  echo "✅ 레인 ${N}개 전부 기대대로"
  if [ "$SKIPPED" -gt 0 ]; then
    echo "⏭  단, peer 부재로 **${SKIPPED}개 레인이 안 돌았다** — 그중 컨트롤이 빠지면"
    echo "   남은 초록은 「늘 PEER_ABSENT 를 내는 계기」와 구분되지 않는다. 초록을 그렇게 읽지 마라."
  fi
else
  echo "❌ 회귀 — 빨강:$RED_LANES (레인 ${N}개 실행 · peer 부재 SKIP ${SKIPPED}개)"
fi
exit "$FAIL"