@chrono-meta/fh-gate 1.4.97 → 1.4.98

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/CATALOG.md +19 -0
  3. package/CHEATSHEET.md +9 -1
  4. package/CLAUDE.md +28 -2
  5. package/README.ja.md +10 -0
  6. package/README.ko.md +10 -0
  7. package/README.md +11 -0
  8. package/README.zh.md +10 -0
  9. package/docs/pillars.svg +3 -7
  10. package/knowledge/shared/harness-core/fh_ecosystem_positioning.md +2 -0
  11. package/knowledge/shared/harness-core/fh_global_positioning_and_distribution_roadmap.md +136 -0
  12. package/knowledge/shared/harness-core/fh_three_layer_canon.md +20 -0
  13. package/knowledge/shared/harness-core/field_verdict_crossfamily_gate.md +215 -2
  14. package/knowledge/shared/harness-core/ship_readiness_gate.md +112 -0
  15. package/knowledge/shared/learnings/subagent_invocations_log.yaml +55 -0
  16. package/package.json +5 -1
  17. package/plugins/fh-commons/.claude-plugin/plugin.json +1 -1
  18. package/plugins/fh-commons/skills/ko-tech-writer/SKILL.md +63 -12
  19. package/plugins/fh-meta/.claude-plugin/plugin.json +1 -1
  20. package/plugins/fh-meta/CHANGELOG.md +65 -0
  21. package/plugins/fh-meta/skills/auto-decorrelation/SKILL.md +30 -0
  22. package/scripts/degrade_direction_scan.sh +10 -1
  23. package/scripts/digest_landing_check.sh +20 -4
  24. package/scripts/fh_node_check.sh +60 -1
  25. package/scripts/fh_session_load.sh +22 -2
  26. package/scripts/frontier_digest_autopilot.sh +229 -0
  27. package/scripts/lane_runner_check.sh +237 -25
  28. package/scripts/package_coverage_check.sh +17 -0
  29. package/scripts/postinstall_notice.js +34 -0
  30. package/scripts/selfcheck.sh +111 -5
  31. package/scripts/test_degrade_scan_shell_probes.sh +75 -0
  32. package/scripts/test_field_canon_lanes.sh +29 -5
  33. package/scripts/test_lane_runner_lanes.sh +221 -0
  34. package/scripts/test_stale_clone_guard_lanes.sh +21 -7
  35. package/scripts/test_version_lockstep_lanes.sh +62 -0
  36. package/scripts/version_lockstep_check.sh +143 -1
  37. package/templates/.git-hooks/pre-commit +22 -1
  38. package/templates/degrade_direction_scan.sh +10 -1
@@ -60,7 +60,7 @@ model: sonnet
60
60
  | 용어-머리 «**X** — 설명» | 글머리 기호 뒤 `** — ` | «**X**: 설명» 콜론형 |
61
61
  | 콜론 나열투 («관측된 분업은: …») | 서술어 없는 `:` 도입 | 완결 문장으로 («…분업은 ~라는 것입니다») |
62
62
  | 조각문 («걸리는 층.») | 서술어 없는 마침 | 서술어 복원 («걸리는 층입니다») |
63
- | 소유 직역 「~을 갖다/가지다」 | `grep -E "을 갖\|를 갖\|을 가지\|를 가지"` | 존재문으로 (**«이전 상태를 갖지 않는다» → «이전 상태가 없다»**). 영어 `have`의 직역이고, 한국어는 소유보다 존재로 말한다. 소유가 실제 논점인 자리(권한·지분)는 남긴다 |
63
+ | 소유 직역 「~을 갖다/가지다」 | `grep -nE "을 갖|를 갖|을 가지|를 가지"` | 존재문으로 (**«이전 상태를 갖지 않는다» → «이전 상태가 없다»**). 영어 `have`의 직역이고, 한국어는 소유보다 존재로 말한다. 소유가 실제 논점인 자리(권한·지분)는 남긴다 |
64
64
  | 내부 조어·은어 | 팀 밖에서 안 쓰는 단어 (예: 렌더하다, 초록/빨강을 CI 결과 뜻으로) | 청중 어휘로 평문화. 단, **화면이 어휘를 받치면**(실제 빨간 화면을 가리키는 발화) 유지 가능 — 근거를 적는다 |
65
65
  | 레지스터 드리프트 | 습니다↔해요↔평어 혼재 | 표본 기준 단일화 |
66
66
 
@@ -113,6 +113,34 @@ Done When에서 서로 다른 check-class로 채점된다.
113
113
  새기 때문이다. 한글 수사("세 배")는 아라비아 전수로도 못 잡으므로 **눈 판정 잔여**로
114
114
  명기하고 통독에서 본다. 자기 눈으로 고른 수치만 채점하는 것은 measured가 아니다.
115
115
 
116
+ ⚠️ **`\b` 경계 금지** — 유니코드 인식 엔진(ripgrep·GNU grep UTF-8 로케일·Python `re` —
117
+ **`grep -P`는 예외다**: `(*UCP)` 없이는 `\w`가 ASCII 한정이라 숫자-한글 사이에 경계가
118
+ 생긴다. 반드시 `rg` 로 고정)에서 **한글은 word 문자**라 숫자와 한글 사이엔 경계가 생기지
119
+ 않는다. `\b\d[\d,]*\b`류 패턴은 숫자 뒤에 한글 조사·단위가 바로 붙는 표기(예: «7개»)를
120
+ 놓친다. **known-pair로 직접 확인**(엔진 고정, 복붙 실행): 이 SKILL.md 자신에 `rg -n
121
+ '\b\d[\d,]*\b'`와 `rg -n '\d(?:[\d,]*\d)?'`(끝자리 콤마를 삼키지 않게 끝을 숫자로 고정)를
122
+ 각각 돌려 델타를 세면, 경계판이 놓치는 숫자가 나온다(측정일 기준 델타 수를 이력에
123
+ 기록 — 놓치는 쪽은 대부분 조사·단위가 바로 붙는 주장 수치이고, 날짜·Step 번호처럼 뒤에
124
+ 공백·기호가 오는 숫자는 양쪽 다 잡힌다). **경계 없는 추출**로 시작하고, 과다추출된
125
+ 비주장 항목은 위 문장대로 사유와 함께 제외한다.
126
+
127
+ ### Step 4-b — 전칭 단정 후보 검출 (오탐 허용 — 후보 표시용, 판정은 사람)
128
+
129
+ «전부/모두/하나도 없다/전혀/일절/예외 없이» 류 전칭 단정 어휘 + **부정형 전칭**을
130
+ `rg -n '(안|못) ?(했|만들|나오|잡히)|지 않았(다|습니다)'`(엔진 고정, 복붙 실행)로 걸러
131
+ 후보로 표시하고, 각 후보의 반례가 정말 없는지 본문·근거를 다시 대조한다. grep은 후보만
132
+ 내고 판정은 사람이 한다 — 오탐 다수가 정상이다. **단, 후보를 세지 않거나 판정을
133
+ 비워두는 것은 결함이다** — 판정할 사람을 구할 수 없으면 후보 목록을 그대로 남기고 이
134
+ 조건을 **미충족으로 명시**하고 발행 판단자에게 넘긴다(자기 판정으로 대체 금지 — Step 5
135
+ 격리 규율과 동형).
136
+
137
+ 실측(비공개 원장, 2026-08-14): 같은 개고 세션에서 반례 탐색 없는 전칭 단정을 두 번
138
+ 썼고, 한 번은 위 어휘 목록에 없는 **부정형**("~을 안 만들었다")이었다 — grep 어휘만으로
139
+ 못 잡는 계열이 실재한다는 뜻이라 부정형 패턴을 함께 넣는다. **반례 탐색 없이 쓴 전칭
140
+ 단정은 원문보다 개고본에서 더 잘 나온다** — 다듬는 행위 자체가 근거 재확인 없이 서술을
141
+ 넓히기 때문이다. Step 5 재콜드리드가 뒤늦게 잡을 수도 있지만, 앞단에서 후보를 먼저
142
+ 좁혀두면 그 라운드의 비용이 준다.
143
+
116
144
  수치·주장에는 **두 가지 라벨**이 있고 서로 다른 상태다 — 섞지 않는다:
117
145
 
118
146
  - **«발행 직전 재측정 대상»** — 근거는 확인됐으나 **시간이 지나면 값이 변하는** 것
@@ -133,10 +161,22 @@ Done When에서 서로 다른 check-class로 채점된다.
133
161
  - **HTML/PDF 렌디션은 조건부** — 요청이 명시했거나 게재 채널이 요구할 때만 만든다(판단
134
162
  주체는 요청/채널이지 저자의 재량이 아니다): 자체완결 HTML(외부 의존 없는 인라인 SVG
135
163
  다이어그램, 시스템 한글 폰트 스택, `@page` 인쇄 규칙) → headless Chrome `--print-to-pdf`.
136
- - **지각 QA(필수 렌더 산출물이 있을 때)**: 렌더 결과를 **전 페이지 눈으로** 확인한다 —
137
- 라벨 잘림(한글 받침), 페이지 나눔, 표/그림 겹침, 다이어그램 텍스트 가림. 도구 exit 0은
138
- 렌더 성공이지 가독성 판정이 아니다. 판정 짝은 **독립 2차 지각 패스**(다른 눈이 같은
139
- 렌더를 봄)다 콜드리드는 내용을 읽지 렌더 결함을 보지 않으므로 짝이 될 수 없다.
164
+ - **md-only 예외의 범위는 좁다** 게재 매체가 md 렌더하면(위키·GitHub 등) **md-only
165
+ 산출물도 렌더 산출물이다.** N/A 게재 매체가 렌더를 하지 않음을 확인한 경우에만 쓴다.
166
+ **매체가 미상이면**(Step 1 «확인 불가» 경로로 진행한 경우) N/A 자격이 없다 GitHub
167
+ 렌더를 기본 렌더러로 가정하고 지각 확인을 수행하며, 가정 사실을 산출물 이력에
168
+ 남긴다.
169
+ 실측(비공개 원장, 2026-08-14): 렌더된 표의 한 셀에 여러 항목이 뭉쳐 기호-뜻 대응이
170
+ 깨졌는데, 원문엔 항목이 전부 적혀 있어 논리적 누락이 없었고 열 수·이스케이프 같은
171
+ 기계 검사도 통과했다. 배경지식 0 콜드리드를 여러 라운드 돌렸는데도 **렌더된 표를 보는
172
+ 사람만** 그 결함을 알아챘다 — «md-only니까 N/A»로 판단한 것이 오판이었다 — 위키가
173
+ md를 렌더하는 순간 렌더 산출물이 생긴다.
174
+ - **지각 QA(필수 — 렌더 산출물이 있을 때, md-only라도 게재 매체가 렌더하면 포함)**: 렌더
175
+ 결과를 **전 페이지 눈으로** 확인한다 — 라벨 잘림(한글 받침), 페이지 나눔, 표/그림 겹침,
176
+ 다이어그램 텍스트 가림, **표 셀 안에 여러 항목이 한 줄로 뭉쳐 있는지**(구분자 반복 —
177
+ 렌더된 표에서만 보이고 원문 grep으론 안 잡힌다). 도구 exit 0은 렌더 성공이지 가독성
178
+ 판정이 아니다. 판정 짝은 **독립 2차 지각 패스**(다른 눈이 같은 렌더를 봄)다 — 콜드리드는
179
+ 내용을 읽지 렌더 결함을 보지 않으므로 짝이 될 수 없다.
140
180
  - **발행 전 콜드리드 1패스**: 격리된 검토가 처음 읽는 눈으로 통독한다. 저자는 자기 글의
141
181
  전제 결손을 못 본다. **격리의 정의**: 저작 맥락을 상속하지 않는 실행이다. 같은 레포에서
142
182
  띄운 서브에이전트는 프로젝트 지침·메모리를 상속하므로 **완전 블라인드가 아니다** — 저작
@@ -148,9 +188,13 @@ Done When에서 서로 다른 check-class로 채점된다.
148
188
  - 🟥 **재콜드리드 — 지적을 반영해 고쳐 썼으면 고친 것을 다시 읽힌다.** 콜드리드 1회는
149
189
  *초안*을 검증할 뿐이고, **발행되는 것은 수리본**이다. 수리는 결함의 주된 출처라서
150
190
  «지적 반영»과 «통과»는 다른 사건이다. 본문이 바뀌었으면 라운드를 하나 더 돈다.
151
- **정지 조건은 라운드 수가 아니라 변경이다** — 그 라운드에 **새 지적이 없거나, 있어도
152
- 본문을 고쳤을 때** 닫는다. 고쳤으면 아직 안 닫힌 것이다. 라운드마다 «지적 n건 · 반영
153
- n건 · 본문 변경 여부»를 이력에 적는다.
191
+ **정지 조건은 라운드 수가 아니라 변경이다** — 그 라운드에 **새 지적이 0건이고 본문
192
+ 변경이 0건일 때만** 닫는다(어느 하나만으로는 안 닫힌다). 고쳤으면 아직 안 닫힌 것이다.
193
+ **미반영 지적이 남으면** 건에 명명된 사유 + 발행 판단자 수락 기록을 붙인다 — 없으면
194
+ 미충족으로 명시(Step 5 다른 judged 조건과 동형 라우팅). 라운드마다 «지적 n건 · 반영
195
+ n건 · 본문 변경 여부 · **Step 4/4-b 스캔을 이 수리본에 재실행했는가(y/n)**»를 이력에
196
+ 적는다 — 수리가 결함의 주된 출처인데 수치·전칭단정 게이트가 초안 기준에 머물면 바로
197
+ 그 자리에서 새 결함이 태어난다.
154
198
  > 실측(2026-08-11): 1차 콜드리드가 초안의 삽입 지점 오류를 잡았고, **그 수리가 새 결함
155
199
  > 3종**(소유 직역 · 문장 길이 124자 · 어휘 반복)을 낳았다. 재콜드리드를 안 돌아 그대로
156
200
  > 발행될 뻔했고, 읽는 사람이 «톤이 다르다»로 먼저 잡았다. 돌려 보니 문체보다 큰 것까지
@@ -166,9 +210,12 @@ Done When에서 서로 다른 check-class로 채점된다.
166
210
  | Step 2 **기계 클래스**(줄표·용어-머리·콜론·조각문·소유 직역) 스캔 잔여 0 — 컨트롤(알려진 양성 1건) 동반, 제외는 명명 사유와 함께 목록화 | measured |
167
211
  | Step 2 **판정 클래스**(내부 조어·레지스터) 통과 | judged — 짝: 콜드리드 통독(통독 후 제외 목록 대조) |
168
212
  | **부분 개고인 경우**(기존 문서에 삽입·수정): Step 2-b 리듬 대조 — 삽입분 각 문장이 본문 길이 상위 10% 이내 ∧ 어간 3회 연속 반복 0. 전문 신규 집필이면 N/A 명기 | measured |
169
- | 본문 수치 전건(기계 추출 분모 기준)이 라벨(창 병기/재측정 대상/미확인) 동반 | measured |
170
- | 렌더 산출물(HTML/PDF/이미지 — 파생 압축 자산 포함) 존재하는 경우 페이지 지각 확인md-only 산출이면 N/A 명기 | judged — 짝: **독립 2차 지각 패스**(다른 눈이 같은 렌더를 봄) |
171
- | 콜드리드가 **변경 없음으로 닫혔다** — 마지막 라운드에 새 지적이 없거나, 있어도 본문을 안 고쳤다. 지적을 반영해 고쳤으면 그 수리본으로 한 라운드 더. 라운드별 «지적 n · 반영 n · 본문 변경 여부» + 격리 수준(강/약) 이력 기록. Step 5 미적용 레지스터(낭독 대본)는 N/A 명기 | judged — 짝: 격리 검토(Step 5 정의) |
213
+ | 본문 수치 전건(기계 추출 분모 기준, `\b` 미사용 경계없는 추출, **발행 직전 최종본 기준**)이 라벨(창 병기/재측정 대상/미확인) 동반 + **한글 수사(세 배·두 배 등) 눈 판정 잔여 목록이 이력에 명기됨(0건이면 «0»으로 기록)** | measured |
214
+ | 전칭 단정(부정형 포함) 후보 grep 스캔을 **발행 직전 최종본**에서 실행 후보 n건 수치 기록 | measured |
215
+ | 후보 n 각각에 반례 확인 결과(«확인함»/«확인 함») 붙음 미판정 0 | judged — 짝: Step 5 콜드리드(통독 후 후보 목록 대조) |
216
+ | **파생 압축 자산인 경우**(Step 0 세 번째 레지스터): 자립성 검사(정본 어휘·주장 범위·은어 대조) 결과가 이력에 존재 — 해당 없으면 N/A 명기 | judged — 짝: 배경지식 0 콜드리드(원문 비열람) |
217
+ | 렌더 산출물(HTML/PDF/이미지 — 파생 압축 자산 포함)이 존재하거나 **게재 매체가 md를 렌더하는 경우**(위키·GitHub 등) 전 페이지 지각 확인 — 게재 매체가 md를 렌더하지 않음을 확인한 경우만 N/A 명기(사유 기록). **매체 미상이면** GitHub 렌더 가정으로 지각 확인 수행(가정 기록) — N/A 불가. Step 5 미적용 레지스터(낭독 대본)는 N/A 명기 | judged — 짝: **독립 2차 지각 패스**(다른 눈이 같은 렌더를 봄) |
218
+ | 콜드리드가 **변경 없음으로 닫혔다** — 마지막 라운드에 **새 지적이 0건이고 본문 변경이 0건**일 때 닫는다(어느 하나만으로는 안 닫힌다). 지적을 반영해 고쳤으면 그 수리본으로 한 라운드 더. **미반영 지적이 남으면** 각 건에 명명된 사유 + 발행 판단자 수락 기록을 붙인다 — 없으면 미충족으로 명시. 라운드별 «지적 n · 반영 n · 본문 변경 여부» + 격리 수준(강/약) 이력 기록. Step 5 미적용 레지스터(낭독 대본)는 N/A 명기 | judged — 짝: 격리 검토(Step 5 정의) |
172
219
  | 정직 수위 분리(Step 3)가 적용됨 | judged — 짝: 발행 승인자 확인 또는 격리 적대 검토. 둘 다 불가하면 **미충족으로 명시 보고**(자기 검토로 대체 금지) |
173
220
 
174
221
  ## 역할 경계 (중복 아님을 명시)
@@ -182,7 +229,11 @@ Done When에서 서로 다른 check-class로 채점된다.
182
229
 
183
230
  독립 실행 및 degrade 경로: phantom-quench·dataviz 미설치 → 해당 라우팅을 수동 대조로 ·
184
231
  WebFetch 불가 → Step 1 «확인 불가» 경로(시도 기록 의무) · headless Chrome 부재 →
185
- HTML/PDF 렌디션을 «미생성»으로 명기하고 md 정본만 산출. degrade는 산출물 이력에 적는다.
232
+ HTML/PDF 렌디션을 «미생성»으로 명기하고 md 정본만 산출 · **Step 4-b 판정 주체(사람) 부재
233
+ → 후보 목록을 그대로 두고 해당 Done When 을 미충족으로 명시**(자기 판정 대체 금지) ·
234
+ **독립 2차 지각 패스 부재 → 렌더 스크린샷을 산출물 이력에 첨부하고 해당 Done When 을
235
+ 미충족으로 명시**(저자가 같은 렌더를 두 번 보는 것으로 대체 금지 — 생성자=평가자가 된다).
236
+ 각 degrade는 산출물 이력에 적는다.
186
237
 
187
238
  **언어 범위**: 이름 그대로 **한국어 전용**이다. Step 0·1·3·4·5의 구조는 언어 무관이지만
188
239
  Step 2 문체 클래스가 전부 한국어 실측이라, 영어 지원은 영어 실측 클래스가 쌓인 뒤 별도
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fh-meta",
3
- "version": "1.4.97",
3
+ "version": "1.4.98",
4
4
  "engines": {
5
5
  "claudeCode": ">=1.0.0"
6
6
  },
@@ -10,6 +10,71 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
10
10
 
11
11
  ## Plugin Level
12
12
 
13
+ ### [1.4.98] — 2026-08-15
14
+
15
+ **fix: 1.4.97 이후 쌓인 출하면 36파일을 실제로 배포한다 — 특히 «있는데 실행에 도달 못 하던» 검증 축 하나**
16
+
17
+ - 🔴 **이 릴리스의 존재 이유 자체가 결함 하나다.** `auto-decorrelation` 에 **Step 6.5 — Standpoint
18
+ axis**(2026-08-14 신설, `crossfamily` 와 직교하는 두 번째 탈상관 축)를 커밋했는데 **버전을 안
19
+ 올렸다.** 플러그인 캐시는 `plugin.json` 버전으로 키잉되므로(`~/.claude/plugins/cache/<mk>/<plugin>/<version>/`),
20
+ 버전이 그대로면 캐시가 무효화되지 않는다 — 즉 **레포에는 있고 어떤 런타임에도 없는 규칙**이 하루
21
+ 넘게 존재했다. 실측(2026-08-15): 설치본 `auto-decorrelation/SKILL.md` 에 `standpoint` **0회** ·
22
+ `Step 6.5` **0회**, 레포본에는 263~291행에 전문. 나머지 34개 스킬은 드리프트 0 — 정확히 이 한
23
+ 파일만 도달 실패했고, 하필 그게 그날 실제로 안 걸린 기능이었다.
24
+ **일반형: 스킬을 고치고 버전을 안 올리면 저자 머신을 포함한 모든 런타임에서 그 수정은 존재하지
25
+ 않는다.** `built_but_not_wired` 의 배포채널 판본이고, 게이트가 «행위자가 읽는 곳»에 있어야 한다는
26
+ gate-locality 원칙이 *배포 지연*이라는 다른 메커니즘으로 재발한 것이다.
27
+ **기존 검사기는 정상 작동했다** — `session_close_check.sh` ④-b 가 「마지막 태그 이후 출하자산
28
+ 변경 → 재출하 제안」을 정확히 발화하고 있었다. 놓친 지점은 검사기가 아니라 **그 출력을 표시필터로
29
+ 잘라 읽은 것**(`| tail -15`)이었다. 새 기계장치를 짓지 않고 기존 절차를 실행하는 것이 이 릴리스다.
30
+
31
+ - **Standpoint 축 신설** (PR #370 · #371 · #378) — 계열(family) 다양성은 *리뷰어의 오류분포*를
32
+ 탈상관시키지만 *리뷰가 대조되는 ground truth* 는 탈상관시키지 않는다. 공유 본체(shared-body)
33
+ 변경에서 «누구의 레포를 기준으로 검증했는가」를 폐쇄 enum 으로 기록한다
34
+ (`tier1` · `tier2(<대상>)` · `tier2b(<대상>)` · `tier3(<대상>)` · `not-applicable` +
35
+ could-not/did-not/did-not-look 3분 degrade). 실행 시점은 **첫 push 이전, 위험판정 분기 없이**.
36
+ 정본 = `knowledge/shared/harness-core/field_verdict_crossfamily_gate.md §7`.
37
+ ⚠️ 정직한 현 상태: 이 필드는 **산문 전용**이다 — pre-commit 훅에 `standpoint` 매치 0건,
38
+ 픽스처 스위트 없음(`crossfamily` 는 21건 + 픽스처로 하드 차단). 첫 거짓값이 기록되면 기계화한다.
39
+
40
+ - **컴패니언 스토어 노드↔노드 스코핑** (PR #368 · #372) — 같은 머신에서 두 하네스가 컴패니언
41
+ 스토어를 공유할 때 서로의 manifest/memory-index 를 되읽던 결함. `fh_hub_identity.sh` 신설로
42
+ 세 호출부의 네임스페이스 판단을 단일 소스로 통일.
43
+ - **레인 배선** (PR #369 · #374) — `test_field_canon` · `test_stale_clone_guard` 재배선(DEBT 2→0),
44
+ 자기-재진술 렌즈 + 임베디드 `--self-test` 디스패처 탐지 신설.
45
+ - **SessionStart 노드 플로어에 origin-behind 탐지** (PR #376) · **frontier-digest 무인
46
+ 파이프라인** (PR #377) · **positioning roadmap 문서** (PR #379).
47
+ - **Homebrew tap 출하** (PR #380 · #383) — `brew install forge-harness`(npm 패키지와 100% parity).
48
+ Homebrew Core 제출은 채택 기준(star 75 / fork 30 / watcher 30, 자기제출 ×3) 미달로 **보류**,
49
+ 재개조건 ~50+ star 로 명시 기록.
50
+ - **ko-tech-writer 수리** (PR #373) — render-artifact 스코프 · 전칭단정 스캔 · 한글 `\b` 정규식 트랩.
51
+
52
+ ---
53
+
54
+ ### [1.4.97] — 2026-08-13
55
+
56
+ **fix: 죽어 있던 게이트 캘리브레이션 배선 · 참조를 「선언」이 아니라 「실제 tarball」과 대조**
57
+
58
+ - **아무 데서도 실행되지 않던 레인 스위트를 배선했다** (PR #360). 실측: `scripts/` 의 43개 스위트
59
+ 중 12개가 selfcheck·git 훅·CI 어디서도 안 돌았고, **그중 9개는 이 패키지에 실린다** — 소비자가
60
+ 받아 놓고 아무것도 부르지 않던 테스트 9종이다. 가장 아픈 둘은 **커밋을 하드 차단하는 게이트의
61
+ 캘리브레이션**이었다(`test_marker_crossfamily_lanes.sh` · `test_marker_floor_lanes.sh`).
62
+ 진척 지표 **DEBT 12 → 2**. 남은 2건은 「돌면 진다, 사유는 머신 전제」로 사유가 측정돼 있다.
63
+ - **vendored git 트리에서의 거짓 FAIL 을 닫았다** — 세 스위트가 `git rev-parse --show-toplevel`
64
+ 로 루트를 잡아, 설치 후 `git init` 한 트리나 node_modules 를 커밋하는 모노레포에서 **바깥 레포**
65
+ 를 보고 HARNESS-ERROR 를 냈다. 스크립트 상대경로로 수리.
66
+ - **`package_coverage_check.sh --vs-tarball`** (PR #361) — 참조 대조의 오라클을 `package.json`
67
+ `files[]`(**선언**)에서 `npm pack --dry-run --json`(**실제 출하 파일셋**)으로 바꾸는 모드.
68
+ npm 부재·비영 종료·파싱 실패 시 **fail-closed**(rc=2 UNMEASURED, 약한 오라클로 폴백하지 않는다).
69
+ `prepublishOnly` 에 배선됐다.
70
+ - **참조 추출기가 `.json` 을 못 보고 있었다** — 정규식 교대가 leftmost-first 라 `.js` 가 `.json`
71
+ 안에서 먼저 물렸고, 모든 JSON 참조가 존재하지 않는 경로로 잘려 조용히 버려졌다. 수리 후 즉시
72
+ 드러난 것 하나가 **소비자-대면 결함**이다: `templates/goal-quench-hook-setup.md` 가
73
+ `cp templates/goal-quench-settings-merged.json .claude/settings.json` 을 지시하는데 **그 JSON 이
74
+ 패키지에 없었다.** 이제 실린다.
75
+ - **`selfcheck.sh` 의 timeout 가드가 한 번도 설치된 적이 없었다** — `local` 이 함수 밖에 있어
76
+ bash 가 대입을 거부했고, 매 실행 stderr 로 자기 실패를 알렸으나 아무도 읽지 않았다. 수리.
77
+
13
78
  ### [1.4.96] — 2026-08-12
14
79
 
15
80
  **fix: 전수 재출하 캠페인 — 「돌았다고 보고하는데 안 도는」 계기들 · 선언이 무효였던 에이전트**
@@ -260,6 +260,36 @@ Distinguish the **unavailable-but-wanted** case (consent given, panel down → `
260
260
  **pmh-repo-local and unreadable from an FH session**, so on this side the typed value + ack is the
261
261
  enforceable layer) from the **declined** case above (chosen floor, first-class, no degrade framing).
262
262
 
263
+ **Step 6.5 — Standpoint axis (2026-08-14, orthogonal to the family ladder above)**: for a
264
+ **shared-body / cross-harness-boundary** change — scoped by *effect* (alters another harness's
265
+ behavior, gate outcome, or interaction contract), not merely by touching a synced file path — also
266
+ emit `standpoint:` alongside `crossfamily:` in the same marker — recruiting family diversity here
267
+ does not substitute for it. Values: `tier1` (content-only, the default) · `tier2(<harness>)`
268
+ (peer-simulated — ran the target's own repo, content only) · `tier2b(<harness>)` (same operator,
269
+ target's real runtime — local wiring visible, but not an independent reviewer) · `tier3(<harness>)`
270
+ (a *different* operator of the target harness ran it — the only fully independent + local-wiring
271
+ rung) · `not-applicable` (no target-harness standpoint exists — most same-repo dispatches) ·
272
+ `DEGRADED_NO_TARGET_ACCESS` / `DEGRADED_NOT_RUN` / `UNKNOWN` (own literals, not crossfamily's). Note
273
+ the naming collision with this session's own persona/viewpoint sense of "standpoint" (the `beginner`/
274
+ `main-player`/`expert` agent roster) — different axis, same English word; do not conflate.
275
+ **Prose-only** — no hook or fixture validates this field yet, unlike `crossfamily:`, and
276
+ mechanizing it is FH's own job (a syncing sibling harness cannot add the check locally without its
277
+ own sync process rejecting the divergence). **Timing — same moment as Axis 2/3
278
+ (steel-quench/phantom-quench), not a follow-up**: run on the local diff before the first push to
279
+ any remote (public or private — no visibility judgment to make), one unconditional rule regardless
280
+ of perceived risk — see `field_verdict_crossfamily_gate.md §7 Sequencing` for why (a real PR pushed
281
+ this exact field to a public repo with two residency leaks in view, caught only after the PR was
282
+ already open). Full field spec, trigger scope, and evidence:
283
+ `knowledge/shared/harness-core/field_verdict_crossfamily_gate.md §7`.
284
+
285
+ **Done When** (Step 6.5): `standpoint:` is emitted whenever the change is a shared-body/
286
+ cross-harness-boundary change by the effect-based trigger above; `not-applicable` carries grounds
287
+ on the same line naming what was checked; **the review ran on the local diff before the first push**
288
+ — a `standpoint:` value first recorded after the PR is already open does not satisfy this condition,
289
+ even if the value itself is correct *[judged — no mechanical anchor today; adversarial pairing: a
290
+ reviewer/challenger may request both the grounds and the pre-push timing be shown in the PR capsule,
291
+ and reject a bare `not-applicable` or a post-hoc value]*.
292
+
263
293
  ## Step 7 — Output
264
294
 
265
295
  Sidecar findings → existing synthesizer / Axes 2-3 marker. **Marker honesty (M-3)**: record
@@ -500,11 +500,20 @@ for f in "${FILES[@]}"; do
500
500
  # `tok in text` (paid⊂prepaid) when the variables aren't named verdict/state (M#4, steel-quench).
501
501
  # C2 closes that: simple var-in-var (not a collection literal / range / for) = a likely
502
502
  # containment check that should be exact/word-boundary if it grounds a verdict. Higher noise; advisory.
503
+ # 2026-08-14: pinned an ALL-CAPS-constant exclusion here that Probe C already carries a few lines
504
+ # up (`in [A-Z_]+\b`) — C2 had drifted out of sync with it. Measured on this repo's own scripts/:
505
+ # 6 raw C2 hits, all `if VAR in {seen,by_name,accepted,packed,PLACEHOLDERS}:` — genuine collection
506
+ # membership, not the substring-containment smell this probe exists to catch. Do NOT also add
507
+ # lowercase collection-name heuristics (`seen`/`by_name`/...) here — that class still needs a
508
+ # human to read the assignment and confirm it is a set/dict/list, and a naming guess would just
509
+ # move the false-negative risk instead of removing it. This narrows one already-established class,
510
+ # it does not invent a new one.
503
511
  while IFS= read -r m; do
504
512
  emit "$f" "${m%%:*}" "C2:substring-boolean" "bare 'X in Y' in if/return/assert — if this grounds a presence/verdict check, use exact/word-boundary match, not containment"
505
513
  done < <(grep -nE '^[[:space:]]*(if|elif|return|assert|while)[[:space:]]+[A-Za-z_][A-Za-z0-9_]*[[:space:]]+in[[:space:]]+[A-Za-z_][A-Za-z0-9_.]*[[:space:]]*[:)]?[[:space:]]*$' "$f" 2>/dev/null \
506
514
  | grep -vE '\bfor\b|in range|in enumerate|not in' \
507
- | grep -vE '\b(verdict|present|ground|state|match|expected)\w*\b')
515
+ | grep -vE '\b(verdict|present|ground|state|match|expected)\w*\b' \
516
+ | grep -vE 'in [A-Z_]+[[:space:]]*[:)]?[[:space:]]*$')
508
517
 
509
518
  # Probe E — negated-falsy guard returning permissive (dominance-benchmark round-2 f2 class): an error
510
519
  # SENTINEL (None / {} / "" / []) is falsy, so `if not X: return <PASS>` treats "the check errored / never
@@ -187,10 +187,26 @@ do_check() {
187
187
  # git 추적 파일 → **커밋 시각**(`git log --since=@epoch`). mtime 은 브랜치 전환·체크아웃으로
188
188
  # 갱신되므로 tracked 에서는 신뢰할 수 없다 — 실측으로 확인된 오탐 원인.
189
189
  # gitignored → mtime 밖에 없다(`tracks/**`). 남는 취약면이고 아래에 명명한다.
190
- local _dts; _dts="$(stat -f %m "$d" 2>/dev/null || stat -c %Y "$d" 2>/dev/null)"
191
- if [ -z "${_dts:-}" ]; then
192
- echo "❌ digest mtime 읽었다 선후 판정 불가" >&2; return 10
193
- fi
190
+ # ⚠️ **GNU-first, and then VALIDATE — 순서만으로는 부족하다.** 초판은 `stat -f %m || stat -c %Y`
191
+ # (BSD-first)였고 **리눅스에서 조용히 fail-open 했다**: GNU 의 `-f` 는 `--file-system` 이라
192
+ # 일반 파일에 대해 **exit 0** 으로 파일시스템 리포트(`File: Blocks: …`)를 뱉는다. 즉 `||`
193
+ # 폴백이 영영 안 돌고 `_dts` 에 epoch 대신 여러 줄 blob 이 들어간다 → `git log --since="@<blob>"`
194
+ # 이 파싱 실패 → tracked 대상 **0개** → 「착지 0건」으로 렌더된다. 이 계기가 막으려고 존재하는
195
+ # 바로 그 미측정-을-0으로 렌더가 계기 자신에게서 났다([[feedback_not_found_is_not_zero_family]]).
196
+ # 아래 `[ -z ]` 가드는 blob 이 **비어 있지 않아서** 못 잡았다 — 존재검사는 진위를 못 본다.
197
+ # 실측 2026-08-15: macOS 10/10 PASS · ubuntu:24.04 컨테이너 및 CI(ubuntu-latest) 1/10 FAIL
198
+ # (positive arm `★N-git b` 만 죽는다 = negative 만 통과하는 하네스). 이 레인이 selfcheck 에
199
+ # 배선되기 전에는 아무도 안 돌려서 비용이 0이었다 — 배선이 가정을 표면화한 판본
200
+ # ([[feedback_wiring_surfaces_hidden_failures]], 같은 `stat -f` 원인의 재발).
201
+ # 정수 검증까지 두는 이유: 순서는 플랫폼이 하나 더 늘면 다시 깨지지만, "정수가 아니면 에러"는
202
+ # 안 깨진다. sync-from-be.sh:116 · fh_session_load.sh:105 가 같은 함정을 이미 주석으로 남겼다.
203
+ local _dts; _dts="$(stat -c %Y "$d" 2>/dev/null || true)"
204
+ case "${_dts:-}" in ''|*[!0-9]*) _dts="$(stat -f %m "$d" 2>/dev/null || true)" ;; esac
205
+ case "${_dts:-}" in
206
+ ''|*[!0-9]*)
207
+ echo "❌ digest mtime 을 못 읽었다(stat 출력이 epoch 정수가 아니다) — 선후 판정 불가" >&2
208
+ return 10 ;;
209
+ esac
194
210
  while IFS= read -r f; do
195
211
  [ -n "$f" ] || continue
196
212
  case "$f" in *.md) ;; *) continue ;; esac
@@ -151,6 +151,64 @@ IDENTITY=""
151
151
  if [ -z "$PREV_ID" ]; then IDENTITY="first session for this clone"
152
152
  elif [ "$PREV_ID" != "$NODE_ID" ]; then IDENTITY="machine changed ($PREV_ID → $NODE_ID)"; fi
153
153
 
154
+ # ── git-remote freshness (origin) — distinct axis from the infra-delta check above ─
155
+ # INFRA (above) compares against PREV_HEAD, the commit THIS CLONE last saw — it cannot detect
156
+ # "origin has commits I never pulled" because it never talks to the remote. Measured 2026-08-15:
157
+ # a machine idle for two weeks sat 145 commits behind origin/main with zero signal from this hook
158
+ # (companion-store sync covers only the gitignored half; the FH repo itself is a separate git
159
+ # transport with no freshness check of its own). Condition, not event — reported every session
160
+ # while true, same as MISS above.
161
+ #
162
+ # WHY THE TARGET REF IS THE LOCAL main BRANCH, NOT `git symbolic-ref --short HEAD`: an earlier
163
+ # revision compared `HEAD..origin/<current-branch>`. Two bugs, one catch (fh-meta:challenger
164
+ # 2026-08-15 [HIGH]): (a) on a detached HEAD, `symbolic-ref` fails and silently fell back to the
165
+ # literal string "main" — not empty — so the "not measurable, stay silent" case never triggered
166
+ # and it happily compared against the wrong ref; (b) on a feature branch — this repo's own normal
167
+ # workflow (CLAUDE.md §PR Direction: never commit main directly) — it compared against
168
+ # origin/<feature-branch>, never origin/main, so the exact incident this check exists to catch
169
+ # (idle main sitting behind) would NOT have been caught while checked out on a feature branch.
170
+ # Fix: always measure the LOCAL main branch REF directly (refs/heads/<default>), independent of
171
+ # what is currently checked out. Default branch name is read from origin/HEAD, falling back to
172
+ # "main" only if that symref is absent (e.g. never fetched before).
173
+ GIT_BEHIND_NOTE=""
174
+ if git -C "$FH" rev-parse --git-dir >/dev/null 2>&1 && git -C "$FH" remote get-url origin >/dev/null 2>&1; then
175
+ export GIT_TERMINAL_PROMPT=0
176
+ # GIT_SSH_COMMAND: fh_session_load.sh's companion-store fetch sets this (BatchMode + accept-new
177
+ # host keys) so an SSH remote with an unrecognized host key fails fast instead of hanging on an
178
+ # interactive prompt that GIT_TERMINAL_PROMPT=0 alone does not suppress (ssh, not git, owns that
179
+ # prompt). This block had copied the timeout half of that pattern but not the SSH half — same
180
+ # challenger round caught the drift live, not hypothetically.
181
+ export GIT_SSH_COMMAND="${GIT_SSH_COMMAND:-ssh -o BatchMode=yes -o ConnectTimeout=5 -o StrictHostKeyChecking=accept-new}"
182
+ # Same bounded-fetch pattern as fh_session_load.sh's companion-store pull: a SessionStart hook
183
+ # must never hang the first turn on a slow/stalled network step. perl-alarm is the portable
184
+ # watchdog; no perl → run unbounded rather than silently never fetch (same tradeoff as there).
185
+ # Deliberately a DISTINCT env var from that script's FH_FETCH_DEADLINE (this fetch targets a
186
+ # different remote — the FH repo's own origin, not the companion store's) — sharing the name
187
+ # would let tuning one fetch's timeout silently retune the other (challenger 2026-08-15).
188
+ if command -v perl >/dev/null 2>&1; then
189
+ _fh_gitcheck_deadline() { perl -e 'alarm shift @ARGV; exec @ARGV' "$@"; }
190
+ else
191
+ _fh_gitcheck_deadline() { shift; "$@"; }
192
+ fi
193
+ if _fh_gitcheck_deadline "${FH_NODE_GIT_FETCH_DEADLINE:-8}" git -C "$FH" fetch --quiet origin >/dev/null 2>&1; then
194
+ _DEFAULT_BRANCH="$(git -C "$FH" symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null | sed 's#^origin/##')"
195
+ [ -n "$_DEFAULT_BRANCH" ] || _DEFAULT_BRANCH=main
196
+ if git -C "$FH" show-ref --verify --quiet "refs/heads/$_DEFAULT_BRANCH" \
197
+ && git -C "$FH" show-ref --verify --quiet "refs/remotes/origin/$_DEFAULT_BRANCH"; then
198
+ _BEHIND="$(git -C "$FH" rev-list --count "refs/heads/$_DEFAULT_BRANCH..refs/remotes/origin/$_DEFAULT_BRANCH" 2>/dev/null || echo "")"
199
+ case "$_BEHIND" in
200
+ ''|*[!0-9]*) : ;; # not measurable — silent, not a claim
201
+ 0) : ;;
202
+ *) GIT_BEHIND_NOTE="local $_DEFAULT_BRANCH is ${_BEHIND} commit(s) behind origin/$_DEFAULT_BRANCH — run: git checkout $_DEFAULT_BRANCH && git pull --ff-only (or: git merge --ff-only origin/$_DEFAULT_BRANCH)" ;;
203
+ esac
204
+ fi
205
+ # no local branch named $_DEFAULT_BRANCH at all (e.g. a fork never checked it out) → silent,
206
+ # not measurable by this method.
207
+ fi
208
+ # fetch failure (offline / deadline hit) → silent. Detector-not-gate: absence of signal here
209
+ # must never be misread as "up to date" by a caller, so it prints nothing rather than a claim.
210
+ fi
211
+
154
212
  # ── state write — unconditional, and a failure is reported, never swallowed ────
155
213
  # Writing only when the check speaks would make the recorded timestamp mean "last time it spoke",
156
214
  # and a write failure would make this banner repeat forever with no explanation.
@@ -161,7 +219,7 @@ if ! { mkdir -p "$(dirname "$STATE")" 2>/dev/null \
161
219
  fi
162
220
 
163
221
  # ── emit: condition (every session) OR event (once) ───────────────────────────
164
- [ -n "$MISS$COMPANION_NOTE$INFRA$INFRA_NOTE$IDENTITY$STATE_WARN" ] || exit 0
222
+ [ -n "$MISS$COMPANION_NOTE$INFRA$INFRA_NOTE$IDENTITY$STATE_WARN$GIT_BEHIND_NOTE" ] || exit 0
165
223
 
166
224
  if [ -n "$MISS" ]; then
167
225
  echo "🖥️ [node] Missing mechanical floor on this machine (node: $NODE_ID): ${MISS% · }"
@@ -171,6 +229,7 @@ elif [ -n "$IDENTITY" ]; then
171
229
  echo "🖥️ [node] $IDENTITY (node: $NODE_ID) — floors present."
172
230
  fi
173
231
  [ -n "$STATE_WARN" ] && echo " ⚠️ $STATE_WARN"
232
+ [ -n "$GIT_BEHIND_NOTE" ] && echo "🔽 [git] $GIT_BEHIND_NOTE"
174
233
  [ -n "$COMPANION_NOTE" ] && echo " ℹ️ $COMPANION_NOTE"
175
234
  if [ -n "$INFRA_NOTE" ]; then
176
235
  echo " ⚠️ $INFRA_NOTE"
@@ -41,6 +41,20 @@ BE="${BE_DIR:-}" # companion-store path — supplied by the gitignored hook re
41
41
  # Resolved HERE (not at the Mode-D block below) because the frontier-digest check
42
42
  # needs it: on a multi-node setup the digest producer may be a DIFFERENT machine.
43
43
 
44
+ # TM = this hub's tracks-meta namespace under $BE (pmh-dev#68 PR #368 review): this reader used to
45
+ # hardcode "tracks-meta" unconditionally, so a sibling hub reading it after sync-to-be.sh's
46
+ # namespace fix would load FH's own session card/freshness data as if it were its own. Resolution
47
+ # is shared with sync-to-be.sh/sync-from-be.sh via fh_hub_identity.sh. This hook's own contract is
48
+ # "never block the first turn" (see header), so an unresolved identity degrades to the historical
49
+ # unsuffixed "tracks-meta" rather than erroring — that is the pre-fix behavior, not a new failure
50
+ # mode, and it only matters for a hub this file cannot even identify in the first place.
51
+ if [ -n "$BE" ]; then
52
+ _FH_IDLIB="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/fh_hub_identity.sh"
53
+ # shellcheck source=scripts/fh_hub_identity.sh
54
+ [ -f "$_FH_IDLIB" ] && . "$_FH_IDLIB" && fh_resolve_hub_identity 2>/dev/null
55
+ fi
56
+ TM="${TM:-tracks-meta}"
57
+
44
58
  # ── node re-entry floor check ────────────────────────────────────────────────
45
59
  # 이 검사는 scripts/fh_node_check.sh 로 분리했다. 이유: 이 파일(fh_session_load.sh)은 gitignored
46
60
  # settings.local.json 에 등록되므로 새 클론/새 기계에선 애초에 안 돈다 — 검사가 존재 이유가 되는
@@ -112,7 +126,7 @@ _fd_hit() { find "$1" -maxdepth 1 -name "frontier_digest_$(date +%Y_%m_%d)*.md"
112
126
  # (2026-07-30 실측: 프로가 07-24~30 매일 정상 생산 중인데 에어는 7일 연속 FAILED 를 띄웠다.
113
127
  # 계기의 스코프가 대상보다 좁았던 케이스 — 대상은 '오늘 digest 가 있나'지 '이 디스크에 있나'가 아니다.)
114
128
  # 술어는 로컬과 **동일**(glob + -size +1k) — divergent-leniency 를 만들지 않는다.
115
- _fd_ready() { _fd_hit "$FH/tracks/_meta" || { [ -n "$BE" ] && _fd_hit "$BE/tracks-meta"; }; }
129
+ _fd_ready() { _fd_hit "$FH/tracks/_meta" || { [ -n "$BE" ] && _fd_hit "$BE/$TM"; }; }
116
130
  # THE SECOND HALF OF THE SAME SCOPE BUG (2026-07-31). The comment above got the principle right —
117
131
  # "대상은 '오늘 digest 가 있나'지 '이 디스크에 있나'가 아니다" — and then widened the predicate by
118
132
  # exactly ONE surface (the companion store), leaving it file-only. There are TWO live producers:
@@ -226,8 +240,11 @@ CARD_EPOCH=0
226
240
  # 3) Companion files NEWER than the card, in the surfaces that carry landed results/handoffs.
227
241
  # (paper-signals = completed experiments; handoff = cross-session/cross-machine; tracks-meta
228
242
  # = synced session meta.) These are exactly what a stale card fails to point at.
243
+ # ★ "$TM" (not the literal "tracks-meta") — paper-signals/handoff/digests are FH-exclusive areas
244
+ # sync-to-be.sh never namespaces (it does not write them for any hub), only tracks-meta needs the
245
+ # suffix here (pmh-dev#68 PR #368 review).
229
246
  NEWER=""
230
- for sub in paper-signals handoff tracks-meta digests; do
247
+ for sub in paper-signals handoff "$TM" digests; do
231
248
  d="$BE/$sub"
232
249
  [ -d "$d" ] || continue
233
250
  while IFS= read -r f; do
@@ -271,6 +288,9 @@ EOF
271
288
  done
272
289
 
273
290
  # 4) INDEX.md live pointers (the operator's wiki TOC — read-first per CLAUDE.local.md).
291
+ # Deliberately UNSUFFIXED: this is a single shared companion-store index, not a per-hub write
292
+ # target — sync-to-be.sh never writes a $TM-namespaced copy of it, so there is nothing to namespace
293
+ # here either (unlike tracks-meta above, which pmh-dev#68 PR #368 review flagged for exactly this).
274
294
  INDEX_HEAD=""
275
295
  if [ -f "$BE/INDEX.md" ]; then
276
296
  INDEX_HEAD="$(grep -iE 'live pointer|Live pointers' -A 8 "$BE/INDEX.md" 2>/dev/null | head -10)"