@chrono-meta/fh-gate 2.5.1 → 2.7.0

package/plugins/fh-meta/skills/auto-decorrelation/SKILL.md

@@ -202,6 +202,50 @@ re-checks** it against the artifact (phantom-quench back-trace) before accepting
 source-grounded is **dropped, not judged**. No sidecar-only verdict (no weak-local-judge regression).
 Local 4090 = **canary tier** (evidence-of, never terminal verdict).
 
+🟥 **What you SEND decides which axis you get — put the MARKER in the payload, not just the diff**
+(2026-08-19). Sidecars have been receiving the *diff* only. That buys a review of the **code** and
+buys nothing on the **record**: the Axes 2+3 marker is self-attested, and this repo has already
+written down that the closing move is *"cross-family reading that marker"* — then never wired the
+marker into the thing that recruits cross-family. Measured twice: (a) a release marker's false
+`not-applicable` passed the new typed lanes untouched, because **form was correct**; (b) this skill's
+own dispatch on 2026-08-19 sent a diff and no marker, so the round could not have caught a false
+axis claim even in principle.
+
+**So the payload is two parts**: the frozen diff **and** the marker for this change — **as it stands
+at dispatch time**: `axes-run:` · `controls:` · `standpoint:` · `thirdparty:` · `residual:`.
+
+🟥 **`crossfamily:` is NOT in the payload — it is this round's OUTPUT.** Step 6 below says every rung
+*emits* that value and "the rung is not done until its verdict is recorded", so requiring it in the
+thing you send is circular: you would be shipping a field this dispatch has not produced yet. Send the
+marker with that line **absent or `UNKNOWN`**, and fill it from the result. (Caught by a blind
+floor-tier sim of this very paragraph, 2026-08-19 — the first draft listed `crossfamily:` among the
+payload fields and no reader could have satisfied it.) Ask the sidecar one extra
+question: *"does the record match the diff — is any axis claimed that the diff shows no trace of, and
+is any residual missing that the diff implies?"*
+
+⚠️ **Scope, deliberately narrow.** This asks whether the record is **consistent with the artifact**.
+It does NOT ask the sidecar to score honesty — «is this marker truthful» is a *conclusion*, and
+§Mechanization Boundary forbids freezing that into machinery. Consistency is checkable from two
+documents; honesty is not.
+⚠️ **You cannot observe that the sidecar READ it — say so rather than implying otherwise.** Putting the
+marker in the payload and the sidecar actually using it are different events, and nothing here
+distinguishes them: a silently-ignored marker looks exactly like a marker that was read and raised
+nothing. The cheap partial anchor is to require the return to **quote one marker line it checked** —
+a reply that quotes nothing did not demonstrably read it. That is evidence-of-reading, not proof, and
+it does not close §Mechanization Boundary's named self-attestation residual. Three independent
+readers flagged this same gap on the day the paragraph was written (a peer session, and two blind
+floor-tier sims), which is why it is stated here instead of left to the reader to notice.
+
+⚠️ **Prose, not a check** — measured recurrence is 2, below this repo's own N≥3 bar
+(`[[feedback_mechanize_at_repetition_prose_before]]`). On the third occurrence, mechanize it here.
+⚠️ **Residency still governs**: a marker can name company assets. Sanitize before any external-family
+dispatch, exactly as with the diff — the marker is not exempt because it is metadata.
+
+*Origin*: sister-asset read of `raphaelchristi/harness-evolver`'s `harness-critic` agent, whose whole
+role is auditing the **evaluator** rather than the artifact. Its detection signatures (score jumps,
+suspiciously fast convergence) do **not** port — FH markers carry no score — but the *target* does.
+Full assessment incl. what was deliberately not imported: `tracks/_audit/proposal_2026-08-19_sister_harness-evolver.md`.
+
 **Target freeze — a prior drop reason, checked before any of the above (2026-08-17).** Grounding a
 finding against *today's* tree proves nothing if the sidecar reviewed *yesterday's*. Pin before
 dispatch and verify on return:

package/plugins/fh-meta/skills/fh/SKILL.md

@@ -46,6 +46,37 @@ the session card and CATALOG, exactly as the greeting path would.
 End with "pick a door, say a phrase, or just state your task". Do not auto-run anything — this
 command is a map, not a dispatcher.
 
+
+## Step 3.5 — 가이드 · Q&A (📖 문을 골랐을 때만 진입)
+
+🟥 **Q&A 는 net-new 기능이 아니다.** FH 에 대해 묻고 답하는 것은 이미 된다(CLAUDE.md 가 상주라
+세션이 문·게이트·스킬을 안다). 이 절이 더하는 것은 **하나뿐**이다 — 「무엇을 근거로 답하나,
+그리고 없으면 없다고 말한다」는 **계약**. 그래서 새 스킬을 만들지 않고 여기 붙인다.
+
+**ⓐ 가이드** — `docs/USER_GUIDE.md` 의 **경로와 3줄 목차**를 출력한다. 승인하면 플랫폼 opener 를
+제안한다(`uname -s`: Darwin→`open` · Linux→`xdg-open` · MINGW/MSYS→`start`). opener 가 없으면
+조용히 건너뛴다 — 경로는 이미 나갔으므로 손실이 없다.
+🟥 **전문 인라인 출력 금지.** 자동 실행도 안 한다.
+
+**ⓑ Q&A** — 1문 1답. 근거는 아래 코퍼스 **안에서만** 찾는다:
+
+```
+1 docs/USER_GUIDE.md              사용법 · FAQ
+2 CHEATSHEET.md                   명령 · 트리거 문구
+3 knowledge/shared/GLOSSARY.md    용어
+4 README.md §Get started/§Learn more   설치 · 진입 경로
+5 CATALOG.md                      「예전에 뭐 했지」
+6 설치된 SKILL.md frontmatter     「무슨 스킬 있어」
+```
+
+**degrade — 코퍼스에 없으면**
+🟥 **지어내지 않는다.** 「못 찾음 — 코퍼스 N개를 봤고 여기엔 없다」 + **다음 한 걸음**(어느 파일을
+열지 · `/install-doctor` 같은 실제 진단 경로)을 준다. 「아마 이럴 것이다」 형태의 답은 **금지**다.
+이건 §Instrument Calibration 의 «미측정을 0으로 렌더하지 않는다» 와 같은 규율이다.
+답마다 `file:line` 을 단다 — 근거 없는 문장은 팬텀이다.
+
+⚠️ 코퍼스 밖 질문(도메인 작업 · 코드)은 이 절이 아니라 평소대로 처리한다. Q&A 는 **FH 사용법**용이다.
+
 ## Done When
 
 | Condition | Check class |

package/plugins/fh-meta/skills/goal-quench/SKILL_detail.md

@@ -214,7 +214,7 @@ fi
 No Stop hook is required. After the Codex goal/session completes, resolve changed files with git and run:
 
 ```bash
-FH_BACKEND=codex npx @chrono-meta/fh-gate "{changed-files}" quick codex-goal
+FH_BACKEND=codex npx --package @chrono-meta/fh-gate fh-gate "{changed-files}" quick codex-goal
 ```
 
 For high-stakes or external-facing work, use `full` instead of `quick`. Treat `BLOCKED` or `ESCALATE` the same as the Claude path: fix and re-run the gate, or surface the decision to the user.

package/plugins/fh-meta/skills/harness-doctor/SKILL.md

@@ -149,7 +149,13 @@ running tool itself). Full procedure: `knowledge/shared/harness-core/measurement
 `M-n · <verbatim row text or its threshold> · <measured value>`. If you cannot quote the row, **you do not
 have a finding** — downgrade to an observation. Origin (2026-07-20, instrument defect n+4, the *fourth* in
 a single run): a run fired `M-1 · CLAUDE.md 816 lines — exceeds the FH threshold of 500`. The string `500`
-does not occur anywhere in this file (grep: 0 hits), and the meta-harness row it claimed to read says raw
+did not occur anywhere in this file at the time (a later grep finds 2 — both in this narrative, added by
+this very post-mortem; the self-referential claim drifted and is corrected here rather than re-asserted).
+🟥 **And that grep was scoped wrong**: it searched this file only. The 500 was NOT invented from nothing —
+`docs/platform_sustainability.md` carried it as a live standard until 2026-08-20, contradicting this row.
+The lesson is not "the run hallucinated" but **"the absence check was run against the wrong corpus"**
+([[feedback_absence_measurement_needs_control]] — a no-hit grep is evidence only when its scope covers
+where the thing would actually live). The meta-harness row it claimed to read says raw
 line count is **"Not a verdict."** So the run invented a threshold *and* fired a row this skill explicitly
 disables for meta-harnesses — the exact recurrence of the 2026-07-15 inversion documented below, which had
 already been patched *in the skill*. The patch held; the **run** ignored it. A verdict grounded in a

package/plugins/fh-meta/skills/harvest-loop/SKILL.md

@@ -54,6 +54,38 @@ Session end
     │  edit-manifest VERIFY: check pending predictions in edit_manifest.yaml
     │  memory-hygiene scan: staleness check on memory/*.md entries (skip if < 7 days)
     │
+[Step 0-d] Session Retrospective (close_retro 가 granted 일 때만)
+  🟥 새 스킬을 만들지 않는다 — 회고 산출은 그대로 Step 2(contention-layer) → Step 3 → 3.5(등급)
+     로 **이미 있는 파이프라인**을 탄다. 「개선포인트 정리」가 거기서 공짜로 붙는다.
+
+  진입 조건 (기계적, 이 순서로):
+    1. `tracks/_meta/user_adaptation_profile.md` frontmatter 의 `close_retro`
+         granted  → 실행
+         declined → 건너뛴다. **다시 묻지 않는다**(operational_adaptation.md no-re-nag)
+         unset / UAP 부재 / ephemeral → **실행하지 않고, 지어내지도 않는다.**
+           운영자 맥락이면(= `CLAUDE.local.md` 존재, `psa_detect_operator_context()` 와 같은
+           판별자) **최초 마감 1회만** 제안하고 답을 UAP 에 기록한다. 그 이상 묻지 않는다.
+    🟥 `CLAUDE.local.md` 존재가 판별자인 이유는 그것이 **gitignored** 라 fresh clone·CI 체크아웃·
+       워크트리 어디에도 안 따라오기 때문이다. 기각된 후보: 「tracks/_meta 가 비어있지 않음」 —
+       `.gitkeep` 이 tracked 라 **fresh clone 이 만족시킨다**(psa_scan_lib.sh 주석의 실측).
+    🟥 **운영자 맥락이라고 자동 granted 가 아니다.** 파일이 존재해서 승인되는 게 아니라
+       **운영자 발화가 인용돼 기록되는 순간** 승인된다. 전자는 세션이 자기 권한을 넓히는 형태다.
+
+  산출: 오늘자 `tracks/_meta/fh_signal_{date}_{source}.md` 에 `retro: close` 를 달고
+        `## Session Retrospective` 4필드를 채운다(형식 정본 = fh_detail_protocols.md).
+        「없음」·「0」도 유효한 값이고, **비우는 것만 안 된다.**
+
+  Done When:
+    + 오늘자 signal 파일이 존재하고 `retro: close` 를 달고 있다              — mandatory-pass
+    + Session Retrospective 4필드가 전부 채워졌다                             — mandatory-pass
+    + 정정 건수는 **세었지 회상하지 않았다**                                   — measured
+    + FH Registration Candidate 가 비면 그 이유가 한 줄 적혀 있다             — mandatory-pass
+
+  ⚠️ `session_close_check.sh` 에 기계 검사를 **붙이지 않는다.** 값싸게 붙일 수 있는 형태는
+     «오늘자 signal 이 있나» 인데 그건 *존재*만 재고 *회고했나*는 못 잰다 — CLAUDE.md 가 ④ 메모리
+     위생에 대해 같은 이유로 검사를 뺐다(«a check that can be satisfied without doing the work
+     is a decoration»). 같은 판단을 그대로 적용한다.
+
 [Step 0] Regression Guard
     │  Check: does anything from this session conflict with or regress a validated skill?
     │  → Regression detected: flag, route to contention-layer

package/plugins/fh-meta/skills/public-surface-audit/SKILL_detail.md

@@ -25,9 +25,24 @@ if [ -r "scripts/psa_scan_lib.sh" ]; then
   # Feed every tracked file as path<TAB>line, the stream psa_scan_tagged consumes. Sourcing the lib
   # without these calls is a no-op scan — measured on this repo (PSA_STREAM stayed unset), so the
   # calls are spelled out here rather than pointed at.
+  # 🟥 rc 를 반드시 받아라 (2026-08-21 배선 리뷰 S-1). 이 파이프는 **원래 뚫렸던 바로 그 진입점**이고,
+  #    바로 아래 coverage 조건이 `$?` 를 덮으므로 여기서 안 받으면 계약이 소실된다.
+  #    계약: 0=신고할 것 없음 · 1=유출(이미 인쇄됨) · 3=NOT SCANNED(계기 사망)
+  #    ⚠️ `_psa_rc=0` 은 반드시 `while` **밖**에 둔다 — 안에 두면 루프 본문이라 매 줄 초기화되고
+  #       파이프 서브셸에 갇힌다(초판이 그렇게 넣었고 `bash -n` 은 통과했다. 문법은 맞고 의미가 틀린다).
+  _psa_rc=0
   while IFS= read -r f; do
     awk -v p="$f" '{printf "%s\t%s\n", p, $0}' "$f" 2>/dev/null
-  done < /tmp/_psa_tracked.txt | psa_scan_tagged
+  done < /tmp/_psa_tracked.txt | psa_scan_tagged || _psa_rc=$?
+  # 🟥 3 은 «깨끗» 이 아니라 «안 쟀다» 다. 여기서 멈춰야 한다 — 이 스킬은 publish 직전에
+  #    Pre-Publish Gate 가 1번으로 체이닝하는 렌즈이고, 그 자리에서 미측정을 통과시키면
+  #    아래 coverage 줄이 «defaults-only 로는 스캔했다» 는 인상까지 얹는다.
+  if [ "$_psa_rc" -eq 3 ]; then
+    echo "⛔ INSTRUMENT DEAD: the scanner did not run (rc=3). NOT SCANNED is not clean."
+    echo "   Fix first — run under bash (zsh special vars can blank PATH inside the matcher),"
+    echo "   and confirm psa_load ran (PSA_STREAM non-empty). Do NOT report a verdict from this run."
+    exit 3
+  fi
   [ "$PSA_OVERRIDE_PRESENT" -eq 1 ] \
     || echo "coverage: defaults-only — operator literals NOT CONFIGURED (identity/company classes UNSCANNED)"
 else

package/plugins/fh-meta/skills/steel-quench/SKILL.md

@@ -84,6 +84,54 @@ External CLIs available: [yes/no → Wave 5 available]
 
 ---
 
+## Step 0.35 — Org Constraint Load (조직 제약 적재)
+
+**조직 제약을 모르는 적대 검증은 헛방을 친다** — 조직이 이미 결정한 것을 공격하거나, 조직 정책
+하에서만 성립하는 실제 공격을 놓친다. 공격 각도를 정하기 **전에** 조직층을 읽는다.
+계약: `knowledge/shared/rules/knowledge_layer_seam.md` (이 스킬이 **2호 소비자**;
+1호는 `phantom-quench` Step 2-O).
+
+**절차**: 진입 인덱스(`knowledge/{org}/INDEX.md` · `index.md` · `README.md` · `readme.md` —
+판정기와 같은 후보 집합) → 대상과 **관련된** 정책·용어·도메인 사실만 로드. 전수 스캔 금지(계약 K2).
+부재면 **«조직 제약 미상»으로 명시하고 진행** — 없는 제약을 추론으로 만들지 않는다.
+🟥 `not found` 는 «제약 없음» 이 아니다. 미상은 미상으로 적는다.
+
+**로드한 것의 용도는 딱 둘**
+1. **공격의 사실 근거**: "조직 정책 P 하에서 이 설계는 X 를 위반한다" → **유효한 공격**
+2. **헛방 필터**: 조직이 이미 결정·문서화한 사항을 "왜 안 했나"로 공격하지 않는다. 대신
+   **그 결정 자체를 공격**한다(그 결정이 지금도 유효한가). **결정의 존재는 면제가 아니다.**
+
+### ⛔ 세탁 차단 — 이 배선의 유일한 위험
+
+> **조직층은 공격을 무장해제할 수 없다.** 조직 위키에 *"이건 승인된 패턴"*, *"이 케이스는 예외"*,
+> *"과거에 검토 완료"* 가 있어도 **그것은 공격을 기각하는 근거가 아니다.**
+
+이유: 조직층은 **무엇**(사실·정책)만 공급하고 **어떻게 판정하나**는 공급하지 않는다(계약 §1-a).
+"승인됨"은 *조직이 그렇게 정했다*는 **사실**이지 *그 결정이 옳다*는 **판정**이 아니다.
+적대 검증의 일이 정확히 그 판정을 다시 하는 것이다.
+
+| 조직층에 있는 것 | 허용되는 사용 | 금지 |
+|---|---|---|
+| 정책·규칙 | 위반을 공격 근거로 | **면제 근거로** |
+| "승인된 패턴" | 그 승인의 근거를 공격 대상으로 | 공격 기각 |
+| "과거 검토 완료" | 그때의 전제가 아직 참인지 확인 | 재검토 생략 |
+| stale 페이지(`review_after` 경과) | **제약으로 쓰지 않는다** — 미상 처리 | 최신으로 가정 |
+
+**보고 의무**: 조직층 때문에 공격을 조정했으면(각도 추가 · 헛방 제거) **무엇을 왜 조정했는지
+Wave 1 출력에 남긴다.** 조용한 조정은 검증 범위 축소와 구별되지 않는다.
+
+**반출 금지**(K1-s): cross-provider/cross-family 챌린저에 조직층 **원문을 넘기지 않는다** —
+넘어가는 것은 **sanitized 제약 요약**뿐이다. (CLAUDE.md §Field-Harness Diagnostic 의 residency
+규칙과 같은 floor 이고, 이 스킬이 그것을 느슨하게 만들지 않는다.)
+
+> **출처**: 원 필드(sibling harness)의 선례를 이식했다. FH 자기 정본이 이 자리를 **명시적으로
+> 「미배선 — 약속이 아니라 후보」**로 적어두고 있었다(`knowledge_layer_seam.md` §0 배선 현황).
+> 이 절이 그 행을 후보에서 배선으로 옮긴다.
+> 🟥 **이식한 것은 절차이지 그쪽의 기계-주장이 아니다** — 원본에는 훅이 이 절을 강제한다는
+> 취지의 서술이 딸려 있었으나, 실측하니 그 훅 레인이 **존재하지 않았다**(`axis2-defense` 훅 히트 0,
+> 컨트롤 `crossfamily` 21). 그래서 **강제 서술은 안 가져왔다.** 이 절은 오늘 기준
+> **살리언스 층이고 기계 바닥이 없다** — 그렇게 적는 것이 팬텀을 들여오지 않는 유일한 방법이다.
+
 ## Step 0.4 — Specialized Reviewer Discovery
 
 For the target artifact, scan installed agents for a domain-specific adversarial reviewer:
@@ -211,6 +259,55 @@ A finding here is a real-code attack (Wave 1 execution principle) — cite the e
 
 ---
 
+## Wave 1-D — Defense Questions (floor tiers · mechanically required)
+
+Three questions, asked of **your own findings and numbers**, before Wave 1 is done. They are written
+out rather than left to judgment because that is exactly what makes them portable: measured n=6 in
+the origin field, a floor-tier pass executes the attack angles above without defect but **does not
+spontaneously ask these three**, while a stronger tier does. That is a **checklist gap, not a
+capability gap** — and by `sonnet_floor_doctrine.md` a harness whose behaviour depends on which model
+is driving is *defective*, not merely limited.
+
+| # | Question | What a real answer looks like |
+|:---:|---|---|
+| **재현성** | Can another session reproduce this verdict from the same inputs? | The exact command, or `file:line`, another session runs. "It's reproducible" is not an answer. |
+| **비교공정성** | Were the two arms measured under the same conditions? | reps, inputs and environment named for **both** arms. An asymmetry you found and left in place counts — say so. |
+| **추정층위** | Is each number a measurement, an estimate, or a quotation? | Which, per number — and for a measurement, what showed the instrument works **on this target** (known-pair). |
+
+**Where the answers go** — one line in the Axes 2+3 marker:
+
+```
+axis2-defense: reproducibility=<…> fairness=<…> estimation-layer=<…>
+```
+
+**Enforcement, stated exactly.** `templates/.git-hooks/pre-commit` → `validate_defense_leg()` runs
+this **at the floor tiers only** (`floor-status: sonnet-floor` or `below-floor`), and checks
+**presence · completeness · non-vacuity**: all three sub-answers must exist and `ok`/`yes`/`n/a` is
+rejected as a filled form rather than an answer. Fixtures: `scripts/test_marker_defense_lanes.sh`
+(17 lanes: known-pairs both directions, two over-block controls, four prescription assertions, and a
+call-site pin — because a suite that extracts the function and calls it directly stays green when
+the hook stops calling it, which is precisely the failure being imported against).
+🟥 **It cannot check whether the answers are TRUE.** That stays with the operator and the weekly
+audit, exactly like every other marker field — do not read the hook's PASS as verification.
+
+**Why the trigger is narrow.** `below-floor` occurs **0 times** across the existing marker corpus, so
+gating on it alone would be a decoration that never fires; `sonnet-floor` occurs 11. The wide reading
+("any marker carrying numbers") is deliberately **not** taken — pricing this axis at a near-universal
+rate is the over-trigger `field_verdict_crossfamily_gate.md §7` rejects, and a field required
+everywhere becomes a rubber stamp.
+
+> **Provenance, and what was deliberately NOT imported.** Absorbed from a sibling harness
+> (2026-08-20). That document additionally amends its floor rule so a below-floor pass carrying this
+> line **plus** a crossfamily record passes **without the operator ack**. 🟥 That is a *loosening* of
+> an existing FH gate and **was not adopted** — here the leg is purely additive and `below-floor`
+> still requires `below-floor-ack`, unchanged.
+> 🟥 The same document asserted its own hook read this field and its own fixture suite pinned it.
+> Measured twice with a control (`crossfamily` → 21 hits in the same files): **both were 0**. The
+> prose was portable; the machine was not. Everything claimed in this section's *Enforcement*
+> paragraph was built here, and the fixture file named there is the receipt.
+
+---
+
 ## Wave 2 — Defense Principles
 
 **3 Defense Principles**: (1) Reinforce with external cases via WebSearch — "unique to us" or "structural pattern"?

package/scripts/adapters/fixtures/mate_agent_boundary_known_negative.md

@@ -0,0 +1,31 @@
+# [CALIBRATION FIXTURE — known-negative] 정보경계 불변식이 **빠진** 합성 명세서
+
+> 🟥 **이것은 실행되는 에이전트 정의가 아니다.** `scripts/blackbox_invariant_check.sh` 의
+> 캘리브레이션 쌍 중 **막혀야 하는 쪽**(expect = FAIL, exit 1)이다. 짝은
+> `agent_boundary_known_positive.md`.
+>
+> 이 파일이 필요한 이유: 양성만 세우면 「불변식이 살아있다」와 「검사기가 아무것도 안 본다」가
+> 같은 초록으로 보인다. 음성 arm 은 계기에 **판별력이 있는지**를 재는 자리다.
+>
+> **의도적으로 위반한다** — 불변식 문장들을 전부 뺐다. 실 식별자는 담지 않는다(그건 T1 이
+> 잡는 별개의 위반이고, 여기서 그것까지 트리거하면 어느 축이 막았는지 흐려진다).
+
+## 입력 인터페이스
+
+외부 findings 를 받는다. `finding_id` 는 불투명 식별자다(어휘 제약 없음).
+`location` 은 특정 접두어가 보이면 폐기한다(denylist).
+
+## 투영 규칙
+
+주입 파이프가 민감 정보를 지운다. 받은 입력은 그대로 담아 하위로 전달한다.
+금지 대상은 이 레포 밖의 파일이다.
+
+## 안전 규칙
+
+1. 판정 근거는 인용 가능한 증거로 남긴다.
+2. 증거 없는 추정은 신뢰도를 올리지 않는다.
+3. 실패를 성공으로 삼키지 않는다.
+4. 재현 절차 없이 수정안을 제시하지 않는다.
+5. 도메인 데이터는 로그에 남기지 않는다.
+6. Read·Grep·Glob 으로 금지된 소스를 열지 않는다.
+7. 신뢰도는 근거의 강도에 따라 정한다.

package/scripts/adapters/fixtures/mate_agent_boundary_known_positive.md

@@ -0,0 +1,56 @@
+# [CALIBRATION FIXTURE — known-positive] 정보경계 불변식 합성 명세서
+
+> 🟥 **이것은 실행되는 에이전트 정의가 아니다.** `scripts/blackbox_invariant_check.sh` 의
+> 캘리브레이션 쌍 중 **통과해야 하는 쪽**(expect = PASS, exit 0)이다. 짝은
+> `agent_boundary_known_negative.md` 이고 그쪽은 막혀야 한다(expect = FAIL, exit 1).
+>
+> **왜 실물 명세서를 쓰지 않나**: 실물은 팀이 계속 고치는 살아있는 문서라, 그것을 양성
+> arm 으로 쓰면 계기의 판정이 남의 편집에 따라 조용히 뒤집힌다(감사 대상은 얼려야 한다).
+> 실물 명세서는 인자 없는 기본 대상으로 계속 검사된다 — 이 파일이 그것을 대체하지 않는다.
+>
+> 식별자는 전부 합성이다. 실제 서비스·레포·필드 이름은 한 건도 담지 않는다.
+
+## 입력 인터페이스
+
+외부 정적분석에서 온 findings 를 받되, 이 에이전트는 그 findings 의 **원본 소스**를 절대
+읽지 않는다. 주입 측이 투영한 결과만 본다.
+
+- `finding_id` — 불투명 식별자. 어휘 제약: `^[a-f0-9]{6,64}$` 만 허용한다.
+  자유문자열이면 경로·발췌를 실어 나르는 우회 운반 채널이 된다.
+- `location` — allowlist 정규식 `^<FE-REDACTED>::[0-9]+$` 만 허용한다.
+  denylist(“특정 접두어가 보이면 폐기”)는 상대경로·`file:///` 등으로 뚫린다.
+
+## 투영 규칙
+
+**투영을 수행하는 주체는** 주입 측(파이프라인)이다. 수행 주체를 적지 않으면 redact 규칙이
+수행자 없는 공수표가 된다. 따라서 이 에이전트는 입력을 **"그대로" 전달하지 않는다** —
+투영된 형태만 하위로 넘긴다.
+
+금지 대상은 **위치가 아니라 출처**로 정의한다. 레포 안에 복사된 사본, 빌드 산출물,
+`sourcesContent` 를 담은 소스맵 전부 동일하게 금지다. "레포 밖"으로 정의하면 레포 안
+사본이 통째로 면제된다.
+
+### 현재 배선 상태
+
+이 투영 파이프는 **아직 코드로 구현되어 있지 않다.** 미구현 통제를 구현된 것처럼 적으면
+그 자체가 낙관 방향 결함이다.
+
+그래서 **슬롯은 현재 사용하지 않는다.** 정의되지 않은 절차에 must-never 불변식을 얹지
+않기 위해, 활성화 **경로를 두지 않는다.**
+
+## 안전 규칙
+
+1. 판정 근거는 인용 가능한 증거로 남긴다.
+2. 증거 없는 추정은 신뢰도를 올리지 않는다.
+3. 실패를 성공으로 삼키지 않는다.
+4. 재현 절차 없이 수정안을 제시하지 않는다.
+5. 도메인 데이터는 로그에 남기지 않는다.
+6. **메모리 쓰기 금지** — **출처가 화이트박스면 저장하지 않는다.** 저장된 값은 다음 호출에
+   자동 주입되므로, 읽지 않을 기회조차 없이 세션 경계를 넘어 오염이 지속된다.
+7. 상한 불변식: 외부 findings 근거만 있고 런타임 증거(XML)가 없으면 신뢰도는 MEDIUM 을
+   넘지 못한다. 이 조항은 **다른 모든 조항에 우선**한다.
+8. 금지된 소스의 **능동 탐색**을 하지 않는다. 이 금지는 **도구 무관**이다 — Read·Grep·Glob
+   뿐 아니라 `Bash` 를 경유한 열람도 같은 위반이다. 도구를 열거하는 형태로 적으면 열거되지
+   않은 경로가 그대로 우회로가 된다.
+   필수 채널(리포트·첨부)에서 **조우**한 경우는 별개다: 열기 전에는 알 수 없으므로
+   "읽지 마라"는 이행 불가능한 의무가 된다. 조우 시에는 중단하고 보고한다.

package/scripts/adapters/peer_resolve.sh

@@ -35,6 +35,38 @@
 #   rc=3   NO_ROOTS    — 루트 목록 자체가 비었다(전제 파손. 「없다」가 아니다)
 #   stderr : rc!=0 일 때 한 줄 사유
 
+# ── 단일 소스 배선 (2026-08-21 F-1) ──────────────────────────────────────────
+# 🟥 위 주석이 «스캐너와 같은 순서여야 한다» 고 **관례로** 적어 두었던 그 중복을 여기서 닫는다.
+#    `scripts/fh_track_resolve.sh` 가 track 이름 → 레포 루트 해석의 단일 소스이고,
+#    아래 `FH_PROJECTS_HOME` 팔은 그 라이브러리를 부른다.
+#
+# ⚠️ **`FH_CLUSTER_ROOTS` 팔은 닫히지 않는다 — 조회 모델이 다르기 때문이다.**
+#    라이브러리는 «루트 하나 밑의 `$root/$c`» 를 묻는다. 이 팔은 «임의 절대경로 목록의
+#    `basename` 이 별칭인가» 를 묻는다. 이름만 같고 의미가 다른 둘을 억지로 합치면 그건
+#    이 수리가 막으려는 결함과 같은 종류다. 그래서 그 팔은 자기 열거를 유지한다
+#    (⇒ `fh_peer_alias_candidates` 는 남는다. 부재 메시지와 강등 폴백도 이걸 쓴다).
+#
+# 라이브러리가 없으면 **수리 이전 동작**으로 강등한다 — 다른 세 소비자와 같은 형태다.
+# (폴백은 의도적으로 옛 구현 그대로다. 공백 결함까지 포함해서 «수리 이전» 이다.)
+_FH_TRLIB="$(cd -P "$(dirname "${BASH_SOURCE[0]:-$0}")/.." 2>/dev/null && pwd)/fh_track_resolve.sh"
+# shellcheck source=scripts/fh_track_resolve.sh
+[ -f "$_FH_TRLIB" ] && . "$_FH_TRLIB"
+type fh_resolve_track_root >/dev/null 2>&1 || fh_resolve_track_root() {
+  local n="$1" root="$2" c hits="" first="" nh
+  for c in "$n" "${n}-dev" "$(printf '%s' "$n" | tr '_' '-')"; do
+    [ -d "$root/$c" ] || continue
+    case " $hits " in *" $c "*) continue ;; esac
+    hits="$hits $c"; [ -n "$first" ] || first="$c"
+  done
+  nh=$(printf '%s' "$hits" | wc -w | tr -d ' ')
+  if [ "${nh:-0}" -gt 1 ]; then
+    printf '%s|AMBIGUOUS:%s' "$root/$n" "$(printf '%s' "$hits" | sed 's/^ //; s/ /,/g')"; return 0
+  fi
+  [ -n "$first" ] || { printf '%s|UNRESOLVED' "$root/$n"; return 0; }
+  [ "$first" = "$n" ] && { printf '%s|' "$root/$n"; return 0; }
+  printf '%s|alias:%s' "$root/$first" "$first"
+}
+
 # 별칭 후보 — 닫힌 목록. 스캐너의 `_resolve_root` 와 **같은 순서**여야 한다.
 fh_peer_alias_candidates() {   # $1=name → 후보를 줄 단위로
   printf '%s\n' "$1" "$1-dev" "$(printf '%s' "$1" | tr '_' '-')"
@@ -74,13 +106,33 @@ EOF
       printf 'peer-resolve: 프로젝트 홈이 없다: %s (전제 파손이지 «peer 없음» 이 아니다)\n' "$home" >&2
       return 3
     fi
-    while IFS= read -r c; do
-      [ -d "$home/$c" ] || continue
-      case " $hits " in *" $home/$c "*) continue ;; esac
-      hits="$hits $home/$c"; [ -n "$first" ] || first="$home/$c"
-    done <<EOF
-$(fh_peer_alias_candidates "$n")
+    # 🟥 여기가 단일 소스로 닫힌 자리다. 옛 인라인 루프(별칭 3종 + 공백 구분자 dedup)를
+    #    `fh_resolve_track_root` 로 대체한다. 출력 계약은 **아래에서 옛 표기로 복원**한다 —
+    #    소비자 4종과 레인은 여전히 rc(0/1/2/3) + 옛 stderr 문구를 읽는다.
+    local rr note
+    rr="$(fh_resolve_track_root "$n" "$home" dir)"
+    note="${rr##*|}"
+    case "$note" in
+      AMBIGUOUS:*)
+        # 옛 표기 복원: 라이브러리는 **후보 이름**을 콤마로 주고, 옛 메시지는 **절대경로**를
+        # «, » 로 이어 붙였다. 공백 없는 이름에서는 바이트 동일하다.
+        local _l="${note#AMBIGUOUS:}" _c _paths=""
+        while IFS= read -r _c; do
+          [ -n "$_c" ] || continue
+          if [ -n "$_paths" ]; then _paths="$_paths, $home/$_c"; else _paths="$home/$_c"; fi
+        done <<EOF
+$(printf '%s' "$_l" | tr ',' '\n')
 EOF
+        printf 'peer-resolve: 한 이름에 레포 여럿 — 고르지 않는다: %s\n' "$_paths" >&2
+        return 2
+        ;;
+      UNRESOLVED)
+        first=""   # 아래 공통 «부재» 분기로 떨어진다 (rc=1 · 옛 문구 그대로)
+        ;;
+      *)
+        first="${rr%|*}"
+        ;;
+    esac
   fi
 
   nh=$(printf '%s' "$hits" | wc -w | tr -d ' ')

package/scripts/cluster_capability_scan.sh

@@ -76,6 +76,31 @@ CAP_SUBDIR=".claude/capabilities"
 # 테스트·다른 배치를 위해 `FH_CLUSTER_ROOTS`(콜론 구분 절대경로 목록)로 통째 대체할 수 있다.
 PROJECTS_HOME="${FH_PROJECTS_HOME:-$HOME/projects}"
 
+# track 이름 → 레포 루트 해석은 scripts/fh_track_resolve.sh 가 단일 소스다 (2026-08-21 F-1).
+# 🟥 **이 파일이 그 라이브러리의 원본이다** — 닫힌 별칭 3종 + 별칭 표면화 + 모호거부는 여기서
+#    뽑아낸 것이고, 갈라져 있던 나머지 두 소비자(fh_session_load.sh · field_canon_preload.sh)가
+#    같은 벌을 쓰게 되는 것이 이 배선의 전부다. 이 파일의 동작은 바뀌지 않는다.
+# 라이브러리가 없으면 **수리 이전 동작**(= 아래 인라인 구현)으로 강등한다 — 다른 두 소비자와
+# 같은 형태다. 새 실패 모드를 만들지 않는다.
+_FH_TRLIB="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)/fh_track_resolve.sh"
+# shellcheck source=scripts/fh_track_resolve.sh
+[ -f "$_FH_TRLIB" ] && . "$_FH_TRLIB"
+type fh_resolve_track_root >/dev/null 2>&1 || fh_resolve_track_root() {
+  local n="$1" root="$2" c hits="" first=""
+  for c in "$n" "$n-dev" "$(printf '%s' "$n" | tr '_' '-')"; do
+    [ -d "$root/$c" ] || continue
+    case " $hits " in *" $c "*) continue ;; esac
+    hits="$hits $c"; [ -n "$first" ] || first="$c"
+  done
+  local nh; nh=$(printf '%s' "$hits" | wc -w | tr -d ' ')
+  if [ "${nh:-0}" -gt 1 ]; then
+    printf '%s|AMBIGUOUS:%s' "$root/$n" "$(printf '%s' "$hits" | sed 's/^ //;s/ /,/g')"; return 0
+  fi
+  [ -n "$first" ] || { printf '%s|UNRESOLVED' "$root/$n"; return 0; }
+  [ "$first" = "$n" ] && { printf '%s|' "$root/$n"; return 0; }
+  printf '%s|alias:%s' "$root/$first" "$first"
+}
+
 _die() { printf '❌ %s\n' "$1" >&2; exit "$RC_HARNESS"; }
 
 # ── `.cap` 파일 열거 — **단 하나의 소스** ────────────────────────────────────
@@ -150,20 +175,24 @@ _enumerate_harnesses() {
 # 🟥 그래도 «조용히 추측» 하지는 않는다. 별칭은 **닫힌 목록**이고, 맞은 별칭은
 #    `_ALIAS_USED` 로 표면화된다. 여러 개가 동시에 맞으면 **고르지 않고 모호로 낸다** —
 #    둘 중 하나를 조용히 고르는 것이 이 파일이 반대하는 그 접힘이다.
+# 🟥 이 함수는 이제 **어댑터**다 — 해석은 `fh_resolve_track_root`(단일 소스)가 하고, 여기서는
+#    이 파일의 **표시 계약**으로 옮긴다. 두 계약이 미묘하게 다르기 때문에 조용히 통과시키지
+#    않는다:
+#      라이브러리  `alias:<c>`   ↔ 여기  `경로 별칭 — alias:<c>`  (OK 행의 DETAIL 로 직접 출력됨)
+#      라이브러리  `UNRESOLVED`  ↔ 여기  빈 문자열              (부재는 `_harness_status` 가
+#                                                              UNREACHABLE 로 판정한다)
+#    `AMBIGUOUS:<...>` 는 양쪽이 같은 표기이고 `_harness_status` 의 `AMBIGUOUS:*` 분기가
+#    그대로 받는다. 술어는 `dir` — 이 스캐너는 «디렉토리가 있나» 를 묻는다(git 레포 여부가
+#    아니다). 그 차이는 의도이지 갈라짐이 아니다(라이브러리 헤더 참조).
 _resolve_root() {  # $1=track 이름 → "<root>|<alias-note>"
-  local n="$1" c hits="" first="" note=""
-  for c in "$n" "$n-dev" "$(printf '%s' "$n" | tr '_' '-')"; do
-    [ -d "$PROJECTS_HOME/$c" ] || continue
-    case " $hits " in *" $c "*) continue ;; esac
-    hits="$hits $c"; [ -n "$first" ] || first="$c"
-  done
-  local nh; nh=$(printf '%s' "$hits" | wc -w | tr -d ' ')
-  if [ "${nh:-0}" -gt 1 ]; then
-    printf '%s|AMBIGUOUS:%s' "$PROJECTS_HOME/$n" "$(printf '%s' "$hits" | sed 's/^ //;s/ /,/g')"
-    return
-  fi
-  [ -n "$first" ] && [ "$first" != "$n" ] && note="경로 별칭 — alias:$first"
-  printf '%s|%s' "$PROJECTS_HOME/${first:-$n}" "$note"
+  local rr note
+  rr="$(fh_resolve_track_root "$1" "$PROJECTS_HOME" dir)"
+  note="${rr#*|}"
+  case "$note" in
+    alias:*)    printf '%s|경로 별칭 — %s' "${rr%%|*}" "$note" ;;
+    UNRESOLVED) printf '%s|' "${rr%%|*}" ;;
+    *)          printf '%s' "$rr" ;;
+  esac
 }
 
 # 한 하네스의 상태를 판정한다. 출력 한 줄: "<name>\t<STATUS>\t<n>\t<detail>"
@@ -590,12 +619,25 @@ EOF
   #   ([[feedback_ci_measures_state_not_transition]] 의 데이터 판본).
   #   앵커를 **추적되는 파일**로 옮긴다 — `.claude/capabilities/*.cap` 은 커밋돼 있어
   #   어느 체크아웃에서도 존재한다. 수집 경로가 죽으면 이 카운트가 0 이 되어 빨개진다.
+  # 🟥 2026-08-20 — 이 레인은 **두 군데가 저자의 체크아웃에 결박**돼 있었고, 소비자 설치에서
+  #   전건 적색이었다(실측: 레지스트리 실물 2.5.1 에서 `discover` rc=10 → selfcheck FAIL).
+  #     ⓐ 전제: `discover` 는 `tracks/` 매핑 목록을 전제하는데 `tracks/` 는 gitignored 라
+  #        **배포물에 구조적으로 존재할 수 없다.** 부재는 «능력 0» 이 아니라 **미측정**이므로
+  #        FAIL 이 아니라 이름 있는 SKIP 으로 낸다([[feedback_not_found_is_not_zero_family]]).
+  #     ⓑ 🟥 **초판이 여기서 틀렸고, cross-family(codex/gpt-5.5)가 잡았다 — 자력 적발 0.**
+  #        기대 문자열 `^forge-harness\(hub\)` 를 «폴더명 결박» 으로 읽고 `basename` 유도로
+  #        바꿨는데, **생산자(:128)는 리터럴 `forge-harness(hub)` 를 낸다.** 즉 유도로 바꾸면
+  #        이름이 다른 트리에서 기대와 산출이 갈려 **거짓 FAIL** 이 된다 — 이 파일이 바로 위에서
+  #        경고하는 divergent-normalizer 를 수리가 새로 만든 꼴이다. 되돌렸다.
+  #        진단 정정: 이 라벨은 «디렉터리 이름»이 아니라 **허브의 상수 식별자**다. 양쪽이 같은
+  #        상수를 쓰는 한 어느 체크아웃에서도 일치하므로 결박이 아니다. 결박은 ⓐ 하나였다.
+  local _hubroot
+  _hubroot="$(cd -P "$(dirname "$SELF")/.." && pwd)"
+  tracked_n="$(_cap_files "$_hubroot/.claude/capabilities" | wc -l | tr -d ' ')"
   out="$(bash "$SELF" discover 2>&1)"; rc=$?
-  # ★세는 규칙은 도구와 **같아야 한다**. 초판은 `ls .../*.cap`(비재귀)였는데 도구가 재귀로
-  #   바뀌자 레인만 2를 세고 도구는 5를 세어 거짓 적색이 났다 — 레인 자신이
-  #   divergent-normalizer 가 된 경우다. `_cap_files` 한 벌로 통일한다.
-  tracked_n="$(_cap_files "$(cd -P "$(dirname "$SELF")/.." && pwd)/.claude/capabilities" | wc -l | tr -d ' ')"
-  if [ "${tracked_n:-0}" -lt 1 ]; then
+  if [ ! -d "$_hubroot/tracks" ]; then
+    echo "  ⏭  L13c SKIP — tracks/ 부재라 discover 의 전제가 없다(gitignored, 배포물에 구조적 부재). 미측정이지 «0건» 아님"
+  elif [ "${tracked_n:-0}" -lt 1 ]; then
     f=$((f+1)); echo "  ❌ L13c 전제 파손 — 추적되는 .claude/capabilities/*.cap 이 0건이다(앵커 대상 부재)"
   elif printf '%s' "$out" | grep -qE '^forge-harness\(hub\)[[:space:]]+OK[[:space:]]+'"$tracked_n"'[[:space:]]'; then
     p=$((p+1)); echo "  ✅ L13c 실물 수집이 살아 있다 — 허브 자신의 추적 선언 ${tracked_n}건을 실제로 집었다"