@chrono-meta/fh-gate 3.0.0 → 3.1.0

package/plugins/fh-commons/skills/preprep/preprep_wire.py

@@ -0,0 +1,210 @@
+#!/usr/bin/env python3
+"""pptx-only 자산군 어댑터 — preprep 레인이 읽을 수 있는 형태를 pptx 에서 세운다.
+
+preprep 은 「원고 마크다운 + 빌더 스크립트」를 전제한다. **원고·빌더가 없고 pptx 자체가
+정본**인 자산군엔 그동안 붙일 길이 없었다(신호 §3-4). 이 어댑터가 그 자리를 메운다 — pptx 에서
+세 가지를 뽑아 세운다:
+
+  <out>/manuscript.md   장마다 🖥(화면 텍스트) · 🗣(발표자 노트). 둘 다 pptx 에서 뽑는다
+  <out>/note_map.py     NOTE_MAP — 어느 절이 실제 장으로 배선됐나 (이 어댑터는 절=장 1:1)
+  <out>/surfaces.yaml   표면 선언. canon_terms/jargon_terms 는 이 파일의 basename 으로만
+                        적는다 — root(=<out>) 기준으로 못 찾으면 이제 스킬 위치로 자동
+                        폴백하므로(2026-09-04 수리), 사람이 자기 목록을 만들기 전엔 배포본의
+                        example 을 그대로 가리켜도 UNMEASURED 로 안 죽는다
+
+🟥 이건 «대본을 다시 만드는 것»이 아니다 — **읽기 전용 파생물**이고, 원본 pptx 는 절대 안
+   건드린다. 손으로 고치지 마라 — 재실행이 덮어쓴다.
+🟥 NOTE_MAP 이 전 절을 1:1 로 담으므로 L8 의 BROKEN(배선 끊김)은 이 어댑터 산출물에서
+   구조적으로 안 뜬다. 값을 내는 것은 UNRESOLVED — «화면/앞 절을 가리키는데 대상을 못
+   찾겠다» — 뿐이다.
+
+🟥 **함정(신호 §3-4 실측, 재발 방지로 이 주석과 known-pair 를 같이 둔다)**: 초판은 「첫
+   도형은 제목이니 빼고 나머지만 🖥 로 담자」로 짰다가, **제목 도형 하나뿐인 목차형 장의
+   화면이 통째로 비었다.** 첫 도형도 화면이다 — `_shapes()` 는 절대 첫 항목을 자르지 않는다.
+   `--self-test` 가 known-positive(제목 하나뿐인 장)로 이 재발을 계속 감시한다.
+
+usage:
+  preprep_wire.py <deck.pptx> [--out DIR]
+  preprep_wire.py --self-test
+"""
+import zipfile, re, os, sys
+
+# 텍스트가 있어도 화면으로 안 셀 도형의 name(예: 장식용 섹션 안내 도형). 프로젝트마다
+# 다르므로 사람이 편집하는 자리다 — 비워 두면 아무것도 안 거른다.
+SKIP_SHAPES = ()
+
+
+def _order(z):
+    rels = dict(re.findall(r'Id="([^"]+)"[^>]*Target="slides/slide(\d+)\.xml"',
+                           z.read('ppt/_rels/presentation.xml.rels').decode('utf-8')))
+    lst = re.search(r'<p:sldIdLst>.*?</p:sldIdLst>',
+                    z.read('ppt/presentation.xml').decode('utf-8'), re.S).group(0)
+    return [int(rels[r]) for r in re.findall(r'<p:sldId id="\d+" r:id="([^"]+)"/>', lst)]
+
+
+def _shapes(z, sn):
+    """장 sn 의 화면 도형 텍스트 전부, 등장 순서대로.
+
+    🟥 **첫 항목을 자르지 않는다.** 목차형 장(제목 도형 하나뿐)은 첫 도형을 빼면 화면이
+    0개가 된다 — 신호 §3-4 실사고. `SKIP_SHAPES` 로 걸러진 것을 뺀 **나머지 전부**가 화면이다."""
+    x = z.read('ppt/slides/slide%d.xml' % sn).decode('utf-8')
+    out = []
+    for m in re.finditer(r'<p:(sp|graphicFrame)>.*?</p:\1>', x, re.S):
+        b = m.group(0)
+        nm = re.search(r'name="([^"]*)"', b)
+        nm = nm.group(1) if nm else '?'
+        if nm in SKIP_SHAPES:
+            continue
+        t = ' '.join(re.findall(r'<a:t>([^<]*)</a:t>', b)).strip()
+        if t:
+            out.append((nm, re.sub(r'\s+', ' ', t)))
+    return out
+
+
+def _notes(z, sn):
+    p = 'ppt/slides/_rels/slide%d.xml.rels' % sn
+    if p not in z.namelist():
+        return ''
+    m = re.search(r'notesSlide(\d+)', z.read(p).decode('utf-8'))
+    if not m:
+        return ''
+    npath = 'ppt/notesSlides/notesSlide%s.xml' % m.group(1)
+    if npath not in z.namelist():
+        return ''
+    t = ' '.join(re.findall(r'<a:t>([^<]*)</a:t>', z.read(npath).decode('utf-8')))
+    return re.sub(r'\s+', ' ', t).strip()
+
+
+def build(deck_path):
+    """계산부 — 디스크에 안 쓴다. (manuscript_lines, ids) 를 돌려준다.
+    known-pair 셀프테스트가 파일 없이 이 함수를 직접 부른다."""
+    z = zipfile.ZipFile(deck_path)
+    order = _order(z)
+    lines, ids = [], []
+    for i, sn in enumerate(order, 1):
+        sid = 'S%d' % i
+        ids.append(sid)
+        sh = _shapes(z, sn)
+        head = (sh[0][1] if sh else '(제목 없음)')[:50]
+        lines.append('### %s · %s' % (sid, head))
+        lines.append('🖥')
+        for _nm, t in sh:            # 🖥 전체 — 첫 도형 포함, 절대 자르지 않는다
+            lines.append(t)
+        lines.append('🗣')
+        lines.append(_notes(z, sn) or '(발화 없음)')
+        lines.append('')
+    return lines, ids
+
+
+def write(deck_path, out_dir):
+    os.makedirs(out_dir, exist_ok=True)
+    lines, ids = build(deck_path)
+    open(os.path.join(out_dir, 'manuscript.md'), 'w', encoding='utf-8').write('\n'.join(lines))
+
+    with open(os.path.join(out_dir, 'note_map.py'), 'w', encoding='utf-8') as f:
+        f.write('# 생성물 — preprep_wire.py 가 만든다. 손으로 고치지 마라(재실행이 덮어쓴다).\n')
+        f.write('# 이 어댑터는 절과 장을 1:1 로 배선한다(pptx 자체가 정본인 자산군 전제).\n')
+        f.write('NOTE_MAP = {\n')
+        for k, sid in enumerate(ids, 1):
+            f.write('    %d: (%r, None),\n' % (k, sid))
+        f.write('}\n')
+
+    # 🟥 canon_terms/jargon_terms 는 basename 만 적는다 — 2026-09-04 수리로 root(<out_dir>)
+    #   기준을 먼저 보고, 없으면 스킬 위치(HERE)로 자동 폴백하므로 example 을 그대로 가리켜도
+    #   죽지 않는다(그 자리 대신 「(skill-dir fallback)」 표기가 뜬다). 실전 목록은 사람이
+    #   <out_dir>/ 아래에 같은 이름으로 두면 root 쪽이 우선한다.
+    surf = '''\
+asset_family: "pptx-only 자산군 — preprep_wire 배선"
+root: "."
+canon_ledger: "CANON_LEDGER.md"           # 🟥 사람이 채운다. 없으면 L1-a 는 UNCOVERED 로 뜬다
+canon_terms:  "canon_terms.example.yaml"  # 🟥 root 기준 — 여기 없으면 스킬 위치로 폴백
+jargon_terms: "jargon_terms.example.yaml"
+
+interslide:
+  manuscript: script
+  builder: "note_map.py"
+
+surfaces:
+  - id: script
+    path: "manuscript.md"
+    kind: markdown
+    canonical_for: [발화 문자열, 화면 문자열]
+    unit_pattern: '^###\\\\s+(S[0-9]+)\\\\s*·'
+    speech_marker: "🗣"
+    spoken: true
+    retire_markers: ["🚫", "제거됨", "폐기"]
+
+adjacent_dup:
+  max_dup_chars: 40
+'''
+    open(os.path.join(out_dir, 'surfaces.yaml'), 'w', encoding='utf-8').write(surf)
+    print('세움: %s/manuscript.md (%d절) · note_map.py · surfaces.yaml' % (out_dir, len(ids)))
+    print('🟥 canon_terms/jargon_terms 는 example 을 가리킨다 — 실전은 사람이 %s 에 자기'
+          ' 코퍼스의 금지어/조어 목록을 채워라(파일명을 같게 두면 root 쪽이 우선한다).'
+          % out_dir)
+
+
+def selftest():
+    """known-pair — 신호 §3-4 «첫 도형 유실» 재발 방지. python-pptx 로 최소 덱을 지어 돈다."""
+    import tempfile
+    try:
+        from pptx import Presentation
+        from pptx.util import Inches
+    except ImportError:
+        print('preprep_wire SELFTEST: SKIPPED — python-pptx 없음 (0 아님, UNMEASURED)')
+        return 2
+
+    ok = True
+    with tempfile.TemporaryDirectory() as d:
+        deck = os.path.join(d, 't.pptx')
+        prs = Presentation()
+        blank = prs.slide_layouts[6]
+
+        # known-positive: 제목 도형 «하나뿐»인 목차형 장 — 화면이 비면 재발이다
+        s1 = prs.slides.add_slide(blank)
+        tb1 = s1.shapes.add_textbox(Inches(1), Inches(1), Inches(4), Inches(1))
+        tb1.text_frame.text = '목차'
+
+        # known-negative: 도형 둘(제목+본문) — 둘 다 화면에 남아야 정상
+        s2 = prs.slides.add_slide(blank)
+        tb2a = s2.shapes.add_textbox(Inches(1), Inches(1), Inches(4), Inches(1))
+        tb2a.text_frame.text = '본문 제목'
+        tb2b = s2.shapes.add_textbox(Inches(1), Inches(2), Inches(4), Inches(1))
+        tb2b.text_frame.text = '본문 내용'
+
+        prs.save(deck)
+        lines, _ids = build(deck)
+        text = '\n'.join(lines)
+        i1, i2 = text.index('### S1'), text.index('### S2')
+        block1, block2 = text[i1:i2], text[i2:]
+
+        screen1 = block1.split('🖥', 1)[1].split('🗣', 1)[0]
+        has1 = '목차' in screen1
+        print(f'  {"PASS" if has1 else "FAIL"}  known-positive(목차형 장, 제목 도형 하나뿐): '
+              f'화면에 «목차» {"있음" if has1 else "없음 — 첫 도형 유실 재발!"}')
+        ok &= has1
+
+        screen2 = block2.split('🖥', 1)[1].split('🗣', 1)[0]
+        has2 = ('본문 제목' in screen2) and ('본문 내용' in screen2)
+        print(f'  {"PASS" if has2 else "FAIL"}  known-negative(다중 도형 장, 둘 다 남아야 함): '
+              f'{"둘 다 있음" if has2 else "유실됨"}')
+        ok &= has2
+
+    print('preprep_wire SELFTEST:', 'PASS' if ok else 'FAIL — 첫 도형 유실이 재발했다')
+    return 0 if ok else 1
+
+
+def main():
+    if '--self-test' in sys.argv:
+        return selftest()
+    if len(sys.argv) < 2:
+        print(__doc__)
+        return 2
+    deck = sys.argv[1]
+    out = sys.argv[sys.argv.index('--out') + 1] if '--out' in sys.argv else '_preprep'
+    write(deck, out)
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

package/plugins/fh-commons/skills/preprep/presentation_checklist.md

@@ -52,6 +52,10 @@
       아래를 보면 즉사. (DrawingML: headEnd=시작점, tailEnd=끝점 — 직관과 반대)
 - [ ] **C4. 채운 블록 화살표보다 선 + 삼각 화살촉.** 레퍼런스 덱의 어휘와 맞추면 절반은 간다.
 - [ ] **C5. 아이콘은 흰 선화 · 강조 노드에만 채움색 · 캡션은 도형 아래 작은 회색.**
+- [ ] **C6. 「알고도 남긴 것」과 「몰라서 남은 것」을 갈라 적어라 (2026-09-04 실측).** 팔레트
+      밖 색이나 규칙 밖 값을 **정해서** 남긴 자리가 있으면 그 자리에 이유를 적는다 — C2 와
+      같은 원리를 값 전반으로 넓힌 것이다. 안 적으면 다음 감사자가 같은 것을 다시 «발견»하고,
+      지운 값이 다른 번호로 되살아나기도 한다(실측: 지운 색이 다른 색번호로 되살아나 있었다).
 
 ## D. 언어 — 청중이 실제 쓰는 말
 

package/plugins/fh-commons/skills/preprep/surfaces.example.yaml

@@ -44,6 +44,15 @@ surfaces:
     path: "../scripts/gen_fig_s13b.py"
     kind: figure_source
     canonical_for: [도해 문구]
+  # 🟥 2026-09-05 신설 — 타입 있는 도해 JSON(archify 스키마)을 표면으로 세운다. figure_source 처럼
+  #   그림 «소스»의 문자열이 L1/L5 에 잡히고, 추가로 L12 가 옆의 굽기 영수증(*.receipt.json,
+  #   diagram_from_json.py 가 쓴다)으로 «지금 JSON 의 그림인가 · validate 통과 · 해상도 · viewBox 폭»을 본다.
+  #   render 를 안 적으면 UNMEASURED(0 아님). 손으로 넣은 PNG(영수증 없음)도 UNMEASURED.
+  - id: fig_s44
+    path: "figures/s44_methods_make_gate.workflow.json"
+    kind: diagram_source
+    render: "figures/s44_methods_make_gate.png"
+    canonical_for: [도해 문구]
   - id: wiring
     path: "../scripts/ifkakao_build_deck.py"
     kind: note_map
@@ -139,6 +148,15 @@ progressions:
       - anchor: "더 늘려도"
       - anchor: "입장을 바꾸면"
 
+# ── L12 diagram — 타입 JSON 도해의 굽기 정합 (2026-09-05) ─────────────────────────
+# 값의 근거: 장표 26.67in = 1920pt → 2× = 3840px. viewBox 폭은 archify 글자 배율을 정한다
+# (pt = unit × 1728/폭: 720 이면 라벨 29pt·부제 19pt, 덱 최소 18pt 충족 / 845 면 부제 16pt 미달).
+# 🟥 덱이 다르면 min_px 는 그 덱 폭의 2× 로, max_viewbox_w 는 그 덱 최소 글자로 다시 정한다.
+diagram:
+  min_px: 3840
+  max_viewbox_w: 720
+  min_pad: 0.02
+
 # ── L10 adjacent-dup — 인접 장이 같은 문장을 다시 읽나 ────────────────────────
 # 🟥 구조는 범용이고 **임계는 발표마다 다르다** — 그래서 갈라 놓는다.
 #    미기재면 계기가 «재기만 하고 판정 안 한다» 고 스스로 적는다(조용히 통과가 아니다).

package/plugins/fh-commons/skills/preprep/test_preprep_lanes_rp.py

@@ -0,0 +1,184 @@
+#!/usr/bin/env python3
+"""R1~R5 · P1/P3 self-test — known-pair 계량 + 실물 재현.
+
+exit 0 = 전부 통과 · 1 = 실패 있음 · 2 = 픽스처 생성 불가(python-pptx 부재 등, UNMEASURED)
+
+구성:
+  ① known-pair — `fixtures/mk_slide_fixtures.py` 로 R1·R2·R4·R5·P1·P3 를 테스트 시점에 만든다
+     (R3 는 예외 — 실물 구조 2장을 줄인 `fixtures/fixture_R3_{positive,negative}.pptx` 를 쓴다.
+     선두 줄 판별이 절대좌표·srgbClr 런 구조에 기대므로, 검출기 가정대로 «생성»한 픽스처는
+     검출기 자신을 검증 못 한다 — 자기참조. `tracks-meta` 원장이 지목한 방침)
+  ② --baseline 델타 모드 — 편집 전/후 한 쌍에서 새 어긋남 1건만 잡히는지
+  ③ 실물 재현 — 실제 백업 pptx(환경변수 PREPREP_REAL_CORPUS 가 가리키는 디렉터리, 있을 때만)에 돌려 원장이 인용한 실사고 4+1건이
+     그대로 뜨는지 확인한다. 그 코퍼스가 없는 머신에서는 SKIP(«통과»로 세지 않는다).
+"""
+import os
+import sys
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, HERE)
+sys.path.insert(0, os.path.join(HERE, 'fixtures'))
+
+PASS, FAIL, SKIP = 0, 0, 0
+
+
+def ok(msg):
+    global PASS
+    PASS += 1
+    print('  ✅', msg)
+
+
+def ng(msg):
+    global FAIL
+    FAIL += 1
+    print('  ❌', msg)
+
+
+def sk(msg):
+    global SKIP
+    SKIP += 1
+    print('  ⏭ ', msg, '— SKIPPED (PASS 아님)')
+
+
+def codes_of(deck_path, LSR):
+    deck = LSR.Deck(deck_path)
+    F = LSR.analyze(deck)
+    return F, {k for k, _, _ in F}
+
+
+def run_known_pairs(fx_dir):
+    print('\n[1] known-pair — R1·R2·R4·R5·P1·P3 (생성 픽스처) + R3 (실물 픽스처)')
+    import lane_slide_relations as LSR
+    import lane_geometry as LG
+
+    # R1
+    _, cp = codes_of(os.path.join(fx_dir, 'r1_pos.pptx'), LSR)
+    _, cn = codes_of(os.path.join(fx_dir, 'r1_neg.pptx'), LSR)
+    ok('R1 known-positive 검출') if 'R1' in cp else ng(f'R1 known-positive 미검출 ({cp})')
+    ok('R1 known-negative 무검출') if 'R1' not in cn else ng(f'R1 known-negative에서 오탐 ({cn})')
+
+    # R2
+    _, cp = codes_of(os.path.join(fx_dir, 'r2_pos.pptx'), LSR)
+    _, cn = codes_of(os.path.join(fx_dir, 'r2_neg.pptx'), LSR)
+    ok('R2 known-positive 검출') if 'R2' in cp else ng(f'R2 known-positive 미검출 ({cp})')
+    ok('R2 known-negative 무검출') if 'R2' not in cn else ng(f'R2 known-negative에서 오탐 ({cn})')
+
+    # R3 — 실물 픽스처 (자기참조 회피)
+    r3p = os.path.join(HERE, 'fixtures', 'fixture_R3_positive.pptx')
+    r3n = os.path.join(HERE, 'fixtures', 'fixture_R3_negative.pptx')
+    if os.path.exists(r3p) and os.path.exists(r3n):
+        _, cp = codes_of(r3p, LSR)
+        _, cn = codes_of(r3n, LSR)
+        ok('R3 known-positive(실물 2장) 검출') if 'R3' in cp else ng(f'R3 known-positive 미검출 ({cp})')
+        ok('R3 known-negative(실물 2장) 무검출') if 'R3' not in cn else ng(f'R3 known-negative에서 오탐 ({cn})')
+    else:
+        sk('R3 known-pair — fixture_R3_{positive,negative}.pptx 없음')
+
+    # R4
+    Fp, cp = codes_of(os.path.join(fx_dir, 'r4_pos.pptx'), LSR)
+    Fn, cn = codes_of(os.path.join(fx_dir, 'r4_neg.pptx'), LSR)
+    ok('R4 known-positive 검출(아웃라이어 500자)') if 'R4' in cp else ng(f'R4 known-positive 미검출 ({cp})')
+    ok('R4 known-negative 무검출(동값 분포)') if 'R4' not in cn else ng(f'R4 known-negative에서 오탐 ({cn})')
+
+    # R5
+    Fp, cp = codes_of(os.path.join(fx_dir, 'r5_pos.pptx'), LSR)
+    Fn, cn = codes_of(os.path.join(fx_dir, 'r5_neg.pptx'), LSR)
+    ok('R5 known-positive 검출(비율 30.0)') if 'R5' in cp else ng(f'R5 known-positive 미검출 ({cp})')
+    ok('R5 known-negative 무검출(동일 비율)') if 'R5' not in cn else ng(f'R5 known-negative에서 오탐 ({cn})')
+
+    # P1 — 3팔(임계 안 소폭 이동은 뜼다 · 임계 밖 큰 이동은 안 뜼다 · 무이동은 안 뜼다)
+    lines, compared = LG.collect_lines(os.path.join(fx_dir, 'p1.pptx'), 200000, 63500)
+    p1_lines = [l for l in lines if 'gate_bar' in l]
+    ok(f'P1 대조된 도형-쌍 {compared} > 0 (비교 안함 아님)') if compared > 0 else ng('P1 compared=0 — UNMEASURED')
+    ok(f'P1 후보 정확히 1건(임계 안 이동만)') if len(p1_lines) == 1 else ng(f'P1 후보 {len(p1_lines)}건 (want 1) — {p1_lines}')
+    if p1_lines:
+        ok('P1 유일 후보가 정확히 (1→2p) 소폭 이동 — 큰 이동(2→3p)·무이동(3→4p)은 안 뜬다') \
+            if '1p→2' in p1_lines[0].replace(' ', '') else ng(f'P1 후보가 엉뚱한 쌍을 가리킨다 {p1_lines}')
+
+    # P3
+    lines3, _ = LG.collect_lines(os.path.join(fx_dir, 'p3.pptx'), 200000, 63500)
+    p3_lines = [l for l in lines3 if 'stub' in l]
+    ok('P3 후보 정확히 1건(임계 안 틀/겹침만)') if len(p3_lines) == 1 else ng(f'P3 후보 {len(p3_lines)}건 (want 1) — {p3_lines}')
+
+
+def run_baseline_delta(fx_dir):
+    print('\n[2] --baseline 델타 모드 — 편집 전/후 한 쌍')
+    import lane_geometry as LG
+    new, gone, cmp_b, cmp_c = LG.delta(os.path.join(fx_dir, 'geo_base.pptx'),
+                                        os.path.join(fx_dir, 'geo_edited.pptx'), 200000, 63500)
+    ok('델타 새 어긋남 정확히 1건') if len(new) == 1 else ng(f'델타 새 어긋남 {len(new)}건 (want 1)')
+    ok('델타 사라진 어긋남 0건(깨끗한 기준본)') if len(gone) == 0 else ng(f'델타 사라진 어긋남 {len(gone)}건 (want 0)')
+    ok(f'기준본 대조 {cmp_b} > 0 · 현재본 대조 {cmp_c} > 0') if cmp_b > 0 and cmp_c > 0 \
+        else ng(f'기준본/현재본 대조 0 있음 — UNMEASURED (cmp_b={cmp_b}, cmp_c={cmp_c})')
+    # scan(cfg, root) 래퍼로도 동일하게 도는지 확인 (preprep.py 가 실제로 부르는 경로)
+    cfg = {'surfaces_by_id': {'built_deck': {'path': os.path.join(fx_dir, 'geo_edited.pptx')}},
+           'geometry': {'baseline': os.path.join(fx_dir, 'geo_base.pptx')}}
+    fP, nP = LG.scan(cfg, '.')
+    ok('scan(cfg, root) 래퍼가 델타 모드로 도고 새 어긋남 1건을 notes 에 낸다') \
+        if any('새 어긋남 1건' in n for n in nP) else ng(f'scan() 델타 출력 이상 — {nP}')
+
+
+REAL_BASE = os.environ.get('PREPREP_REAL_CORPUS', '')  # 기본값 없음 — 다른 머신에서 거짓 SKIP 방지(SKIP != PASS)
+REAL_TARGETS = [
+    ('ifkakao26_slides_v1.3_pre-engine-strip_20260904_210857.pptx', 'R1', 40,
+     '선두 줄이 «그러나»로 뒤집는데'),
+    ('ifkakao26_slides_v1.3_pre-40p_20260904_213452.pptx', 'R2', 41,
+     '«이 셋/세 가지»라 부르는데 번호가 없다'),
+    ('ifkakao26_slides_v1.3_pre-38trim_20260904_210428.pptx', 'R4', 38,
+     '화면 250자'),
+    ('ifkakao26_slides_v1.3_pre-40p_20260904_213452.pptx', 'R5', 112,
+     '29.2자/초'),
+]
+
+
+def run_real_corpus():
+    print('\n[3] 실물 재현 (PREPREP_REAL_CORPUS 백업, 있을 때만) — 원장이 인용한 실사고 4+1건')
+    if not os.path.isdir(REAL_BASE):
+        sk(f'실물 코퍼스 미지정/미존재({REAL_BASE or "PREPREP_REAL_CORPUS unset"}) — SKIP, 통과 아님')
+        return
+    import lane_slide_relations as LSR
+    import lane_geometry as LG
+    for fname, code, want_page, want_sub in REAL_TARGETS:
+        p = os.path.join(REAL_BASE, fname)
+        if not os.path.exists(p):
+            sk(f'{fname} 없음 — 재현 건너뜀')
+            continue
+        deck = LSR.Deck(p)
+        F = LSR.analyze(deck)
+        hit = [x for x in F if x[0] == code and abs(x[1] - want_page) <= 1 and want_sub in x[2]]
+        ok(f'{code} 실물 재현 — {fname} 약 {want_page}p — {hit[0][2][:60] if hit else ""}') \
+            if hit else ng(f'{code} 실물 미재현 — {fname}')
+
+    # P1/P3 36p (보너스 확인 — 원장이 명시적으로 요구한 4건에는 없지만 신호 자체의 원적 사건)
+    align36 = os.path.join(REAL_BASE, 'ifkakao26_slides_v1.3_pre-align36_222442.pptx')
+    if os.path.exists(align36):
+        lines, compared = LG.collect_lines(align36, 200000, 63500)
+        hit_p1 = any('s5017' in l and '35000' in l and '35p' in l.replace(' ', '') for l in lines)
+        hit_p3 = any('s5016' in l and 's5017' in l and '35000' in l for l in lines)
+        ok('P1 실물 재현 — 35p→36p s5017 x -35,000') if hit_p1 else ng('P1 실물 미재현')
+        ok('P3 실물 재현 — 36p s5016→s5017 겹침 35,000') if hit_p3 else ng('P3 실물 미재현')
+    else:
+        sk('ifkakao26_slides_v1.3_pre-align36_222442.pptx 없음 — P1/P3 보너스 재현 건너뜀')
+
+
+def main():
+    try:
+        import mk_slide_fixtures
+    except ImportError as e:
+        print(f'❌ python-pptx 또는 픽스처 모듈 부재 — UNMEASURED: {e}')
+        return 2
+    import tempfile
+    fx_dir = tempfile.mkdtemp(prefix='preprep_lanes_rp_')
+    mk_slide_fixtures.build_all(fx_dir)
+    print(f'픽스처 생성: {fx_dir}')
+
+    run_known_pairs(fx_dir)
+    run_baseline_delta(fx_dir)
+    run_real_corpus()
+
+    print(f'\n결과: {PASS} passed · {FAIL} failed · {SKIP} skipped (skip != pass)')
+    return 1 if FAIL else 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

package/plugins/fh-meta/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "fh-meta",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "engines": {
     "claudeCode": ">=1.0.0"
   },

package/plugins/fh-meta/CHANGELOG.md

@@ -1,5 +1,47 @@
 # forge-harness (fh-meta) Changelog
 
+### [3.1.0] — 2026-09-06 — QP 플러그인 · `oracle:` 마커 채널 · preprep 도해 굽기 · FH 전체 지도 발행 · fh-gate GitHub Action
+
+### 왜 minor 인가
+CLAUDE.md §④-b — 새 자산(fh-qp 플러그인 · `oracle:` 채널 · preprep 도해) + 새 게이트 레인 다수 + 행동을 바꾸는 교리(3층 정본 개정). 🟡 **major 로 읽을 여지는 있었다**: fh-qp 는 «제품 QA» 라는 capability *class* 가 FH 에 처음 생긴 것(정책 ⓒ)이다. 다만 폴백 1차판 · 선택 설치 · 기존 게이트 무변경이라 minor 로 뒀다. 정체성 등급은 무변경(다섯 🟢 유지)이라 major ⓑ 사유도 없다.
+
+### 🟥 BREAKING (gate): 마커 `oracle:` 근사키 차단 (#642)
+**무엇이 이제 막히나**: `oracle_type:` · `Oracle:` · `oracle :` 처럼 «oracle 로 시작하는데 정확히 `oracle:` 이 아닌 줄」과, enum 6종 밖의 값. 종전엔 근사키가 조용히 무시돼 «오라클을 적었다고 믿는데 아무것도 안 적힌» 상태가 났다.
+**처방**: `oracle: <known-pair|metamorphic|back-to-back|a-b|human|none — 근거>` 한 줄로 고치거나, 줄을 지운다(**부재는 통과**한다 — 이 필드는 옵셔널이다).
+
+### 🟥 BREAKING (gate): preprep 레인 L12 diagram (#654)
+**무엇이 이제 막히나** — 도해 표면(`kind: diagram_source`)을 **선언한** 덱에서만, 그리고 아래 여덟 가지에서만 rc=1 이 난다: 선언된 PNG 가 디스크에 없다 · 영수증 파싱 실패 · JSON 지문이 영수증과 다르다(고치고 다시 안 구웠다) · showcase validate 통과 기록 없음 · PNG 헤더 읽기 실패 · PNG 폭이 하한 미만 · viewBox 폭이 상한 초과(글자 배율 미달) · 여백이 하한 미만. **도해 표면을 선언하지 않은 덱은 무영향.**
+🟥 **영수증이 «없는» 것은 차단이 아니다 — `UNMEASURED` 로 기록된다**(`lane_diagram.py:62` 가 `notes` 로 보내고 `preprep.py:903` 은 `findings` 가 있을 때만 rc=1). 손으로 넣은 그림은 이 레인이 «못 보는» 것이지 «틀렸다»가 아니고, 그 둘을 접지 않는 것이 이 레인의 설계다.
+**처방**: 위 여덟 중 하나에 걸렸으면 `diagram_from_json.py` 로 다시 굽거나 표면 선언을 지운다. `UNMEASURED` 는 고칠 것이 아니라 «안 쟀다」는 기록이다.
+⚠️ 이 문단의 초판은 「영수증 없는 그림은 차단」이라고 적었다 — 과대 주장이었고, 릴리스 전 cross-family 감사(codex)가 소스에서 잡았다. 자력 적발 0.
+
+### 새로 실리는 것
+- **fh-qp (QP · Quality Platform)** — qasp PAR 의 범용판. 도메인 상수 0, MCP 폴백 1차(Playwright 웹 · computer-use 데스크톱), typed capability 슬롯(미등록). 스킬 4 · `qp_tools.sh` · 레인 29 · 챔버 런 #18 EMIT. 선택 설치: `claude plugin install -s user fh-qp@forge-harness` (#653)
+- **fh-gate GitHub Action** — `action.yml`. typed exit 7값을 boolean 으로 접지 않는 매핑, 모르는 코드는 `UNKNOWN`(fail-closed), 출력 `reviewed` 로 «안 돌았다 ≠ 통과» 를 분리. `fail-on` 기본이 PASS·PENDING 만 통과. 레인 28. 사용례가 `uses: chrono-meta/forge-harness@v3.1.0` 을 가리키므로 **이 태그가 그 자산의 사용 조건**이다 (#658)
+- **마커 옵셔널 `oracle:` 채널** — TR 29119-11 오라클 유형 닫힌 enum 6, 훅은 형식만 검사. 레인 39 · 배선 W6 (#642)
+- **마커 옵셔널 `affected:` 채널** — 「이 변경이 건드리는 것 + 열린 질문」 한 줄. 자리표시자만 있는 값은 차단(제로 영향은 명제상 없다) (#624)
+- **preprep — «도해는 타입 JSON 에서 굽는다»** + 레인 L12 + 앵커 K1~K7. 첫 실사용 121장 덱 (#654). L13 슬라이드 참조 레인(장 번호 참조가 실제 장을 가리키는가) (#662)
+- **FH 전체 지도** — `docs/map/FH_MAP.md` 5층 + archify 인터랙티브 3장, GitHub Pages 로 발행: **https://chrono-meta.github.io/forge-harness/** (#644 #645 #647 #659)
+- **3층 정본 개정** — 3단 공정 = 모든 작업의 방법론 · 4대 엔진 = 출력이 나오는 코어 · 정체성 = 맞물려 나타나는 능력(5대 = 단련된 실물+등급) (#643)
+- **ISO/IEC AI 표준 crosswalk** — 42119-2/3.2/7/8 · TR 29119-11 · 25059 · 42001 Annex A · 5338 · 23894 · TS 8200 (#641) · `docs/STANDARDS_ALIGNMENT.md`
+- **live-eval** — `/prompt-regression` 의 라이브 짝(프로브 12 · 격리 클론 · 4값 채점 · launchd 템플릿) (#625), launchd PATH 에 `timeout(1)` 부재로 12/12 FAILED-TO-RUN 하던 것 수리 (#632)
+- **worktree_reclaim.sh** — 워크트리 제거 «전» gitignored `tracks/**` 회수(목록 파일 먼저 → 복사+검증, 제거는 사람) (#639)
+- **push-zone 게이트** — 비-소유 github.com 원격 push 를 pre-push 에서 차단 (#636) · **outbound query 가드** PreToolUse(WebSearch|WebFetch) (#637) · **residency 폐포 스캔**을 `crossfamily:` grounds 의 `residency=` 토큰으로 (#633)
+- **sim 러너 MCP 격리** — `--strict-mcp-config` 기본. 헤드리스 팔이 운영자 사용자 스코프 MCP 를 상속하던 것 차단 (#651)
+- **pipe_verdict_guard R3** — heredoc 뒤 «리다이렉션만 있는 줄»(zsh NULLCMD `cat` 이 stdin 파이프를 영원히 읽는 형태) 검출. «push 멈춤» 9건의 실제 원인이었다 (#618) · R2 오탐 수리 (#661)
+- 문서: 모델 등급 × 기대 역량 (#635) · `docs/USE_CASES.md` · 카드 규율의 역방향 상주화(«안 닫힌 것이 사라지면 유실») (#656)
+
+### 같이 고친 것
+- `directional_diff_gate.sh` `has_nul` 이중 정의 — 셀프테스트가 자기 사본만 재고 프로덕션 파손에 초록이던 결함 (#634)
+- 챔버 step 5 가 2026-08-17 교리 어휘(CURATED · NOT-APPLICABLE)를 받는다 — **18일간 러너가 교리를 거부하고 있었다** (#620)
+- 헤드리스 런에서 Skill 툴 무음 거부(`--allowedTools`) + 그 플래그가 variadic 이라 뒤따르는 프롬프트를 먹던 인자 순서 (#612 #631)
+- `fh_audit_check.zsh` 빈 허브에서 zsh 미매치 glob 오류 (#613)
+- (허브 오너 노트 · npm 미출하) `sync-to-be.sh` 목적지 가드 — 비-git 디렉토리·외부 레포 서브디렉토리 companion 은 rc=12 거부 (#646)
+
+### 알려진 한계 (이 릴리스 시점)
+- `docs/map/**` 는 `files[]` 밖이라 **npm 배포물에 안 실린다** — GitHub Pages 표면에만 있다.
+- live-eval 문턱 `0.80` 은 **보정 주간(~2026-09-11) 상수**다. rc 는 나오지만 판정에 쓰지 않는다.
+
 ### [3.0.0] — 2026-09-04 — 정체성 다섯 전부 🟢(identity 1.0 을 이 번호가 나른다) · 릴리스 트랙 통일 · 훅 사실 줄 · 게이트 무음 접힘 수리 · 6축 단련
 
 ### 왜 major 인가
@@ -7,7 +49,7 @@ CLAUDE.md §④-b major ⓑ — **정체성 다섯이 «전부» 🟢**(2026-09-
 운영자 결정(2026-09-04): `identity-v1.0.0` 은 정체성 트랙의 마지막 태그, **이후 한 번호** — 이 3.0.0 이 identity 1.0 을 같이 나른다. 🧭 접두 태그는 더 만들지 않는다. 등급의 정본은 여전히 `ship_readiness_gate.md` 의 셀이고 번호는 나르기만 한다.
 
 ### 🟥 BREAKING (gate): pre-commit [Pointers] 게이트가 워킹트리가 아니라 **인덱스**를 읽는다 (#602)
-**무엇이 이제 막히나**: `.md` 를 스테이징한 뒤 디스크에서 지우면(또는 더 고치면) 종전엔 `[ -f ] || continue` 로 Detail-pointer 검사가 통째로 빠졌다 — 깨진 `**Detail**: See §X` 포인터가 조용히 커밋됐다. 이제 `git show ":$f"` 로 스테이징된 바이트를 검사하고, 인덱스에서 못 읽으면 ❌ 로 막는다. **처방**: 스테이징한 것이 곧 커밋되는 것이다 — 디스크 파일을 믿지 마라. 레인 `scripts/test_precommit_pointer_index_lanes.sh`(일회용 클론) 가 옛 훅에선 정확히 P1 만 실패함을 보인다.
+**무엇이 이제 막히나**: `.md` 를 스테이징한 뒤 디스크에서 지우면(또는 더 고치면) 종전엔 `[ -f ] || continue` 로 Detail-pointer 검사가 통째로 빠졌다 — 깨진 Detail 포인터(`**Detail**` + `See <path> §X` 형태)가 조용히 커밋됐다. 이제 `git show ":$f"` 로 스테이징된 바이트를 검사하고, 인덱스에서 못 읽으면 ❌ 로 막는다. **처방**: 스테이징한 것이 곧 커밋되는 것이다 — 디스크 파일을 믿지 마라. 레인 `scripts/test_precommit_pointer_index_lanes.sh`(일회용 클론) 가 옛 훅에선 정확히 P1 만 실패함을 보인다.
 
 ### 🟥 BREAKING (gate): selfcheck 가 명시경로 게이트 인프라(bin/fh-gate·fh-run·fh-goal 등) 부재를 FAIL 로 센다 (#602)
 종전엔 glob 미매칭과 같은 `continue` 로 무음. glob 미매칭 스킵은 그대로. **처방**: 그 파일들이 없어졌으면 files[] 와 selfcheck 목록을 같이 고쳐라.

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

@@ -193,6 +193,63 @@ diversity vs the orchestrator** (orchestrator = Claude/opus → recruit GPT or G
     succeeded where reading-files-itself hung) — or degrade to single-session with a recorded note.
   This is the sidecar twin of `mcp-circuit-breaker` (stop a stuck external call instead of hanging on it).
 
+## Step 4.5 — Residency screen (mandatory, immediately before ANY external-family send)
+
+**Every** payload this skill sends outward — the diff, the marker (Step 5's payload), the prompt
+text itself — crosses a family boundary the moment a codex/agy/gemini sidecar is recruited.
+"Sanitize before external-family dispatch" used to be a prose reminder with no consumer reading it
+back (`[[feedback_half_externalization_slot_without_consumer]]` shape — a slot that exists but
+nothing downstream checks). This step makes it mechanical:
+
+```bash
+python3 scripts/residency_closure_scan.py --files src/a.py docs/b.md   # every file you are about to send, as separate args (zsh: ${=var}, never an unquoted "$var")
+```
+
+`--files` (not the default closure-walk) because what matters is **what you are actually
+sending**, not this skill's own dependency graph. Read the exit code, not the words:
+
+| Exit | Meaning | What to do |
+|---|---|---|
+| 0 | CLEAN — no organizational identifier found **within the scanner's own stated limits** (see its header — this is a screening result, not a safety guarantee) | Send. Record `residency=CLEAN(files=N)` in the crossfamily grounds (Step 6). |
+| 1 | TAINTED — at least one payload file matched a residency pattern | Do not send as-is. Either strip/redact the tainted file(s) from the payload and re-scan, or route to an in-boundary panel member. If it truly cannot be cleaned, record `residency=TAINTED(N files, stripped=no)` and do NOT dispatch — the crossfamily value becomes a `DEGRADED_*` rung, never `panel(...)`. |
+| 10 | HARNESS_ERROR — the scan itself could not run (commonly: no operator-private `.claude/rules/.residency-patterns` override on this machine — the shipped `.defaults` file alone is deliberately insufficient to claim CLEAN, per the scanner's own header) | Do not send. Record `residency=NOT_SCANNED(<reason>)` — same as exit 1's outcome (no dispatch), different reason (*could not screen* vs *screened and found something*). |
+
+🟥 **On a fresh install with no operator pattern file, this WILL be exit 10 every time** — that is
+the scanner's own documented fail-closed default (`residency_closure_scan.py`'s header: "오버라이드
+파일이 없으면 exit 10 이다"), not a bug introduced here. It means: until an operator configures
+their own residency patterns, this skill cannot claim a panel dispatch was screened, so it honestly
+degrades to a `DEGRADED_*` rung with `residency=NOT_SCANNED(...)` instead of silently sending. That
+is not a new block on fresh installs — the crossfamily field already tolerates `DEGRADED_*` without
+hard-failing the commit; it is one more honest reason to be in that state, not a novel one.
+
+**Where the result lands**: `templates/.git-hooks/pre-commit`'s `validate_crossfamily_leg` now
+requires a `residency=CLEAN(...)` token inside the grounds of any `panel(...)` value (grace date
+`RESIDENCY_TOKEN_GRACE_DATE`, no retroactivity on markers dated earlier), and accepts an optional,
+format-checked `residency=(CLEAN|TAINTED|NOT_SCANNED)(...)` token on `DEGRADED_*`/`UNKNOWN`/
+`declined`. Fixtures: `scripts/test_marker_crossfamily_lanes.sh` (`r1`–`r13`). This is the SAME
+typed field Step 6 already emits into — one channel, not a second marker line.
+
+🟥 **A stripped file is invisible to the reviewer, and a reviewer's default read of invisible is
+"absent," not "redacted"** (governor dogfood, 2026-09-05, same-day live use of this Step): two
+TAINTED files were stripped from a real payload and the CLEAN remainder sent cross-family — the
+reviewer came back with a false-positive S-finding, *"runner wiring is missing,"* because the
+wiring actually lived in one of the two files that had just been stripped. Stripping fixes
+residency; it does nothing about the reviewer's next inference, and silence there reads as a hole.
+**So**: whenever a payload is sent with `stripped > 0`, the review PROMPT itself must name the
+omission explicitly — the list of what was left out, and one line per file on what it is
+responsible for (not its content, just its role) — so the reviewer can discount that surface
+instead of flagging it as missing. Record whether this was done: when the token carries
+`stripped=M` with `M > 0`, the same grounds line adds one phrase on whether the omission list
+reached the review prompt, e.g. `residency=CLEAN(files=3, stripped=2) · omission-list: given to
+reviewer`. This is evidence-of-doing, not proof — same shape as Step 5's "quote one marker line it
+checked," and it does not become a new hard-blocking hook check (channel discipline stays a
+grounds phrase here, per the same Mechanization Boundary this whole field already respects).
+
+⚠️ **Scope, same as everywhere else in this file**: CLEAN is a screening result, not a safety
+guarantee (dynamic imports, non-Python artifacts, encoding tricks, and TOCTOU are named, unclosed
+gaps in the scanner's own header). Recording `residency=CLEAN(...)` asserts the scan ran and found
+nothing **within those limits** — it does not assert the payload is safe in some absolute sense.
+
 ## Step 5 — Role split + source-grounded acceptance (S-2)
 
 CC = **governor**, terminal verdict, source-closes. Sidecars = decorrelated **challengers** feeding
@@ -202,6 +259,11 @@ 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).
 
+**Report shape (2026-09-05)**: when the findings are written up (PR body · marker `crossfamily:` expansion · chamber record),
+use `templates/RED_TEAM_REPORT.md` — the five sections mirror ISO/IEC AWI TS 42119-7 (risk identification · objectives & attack
+vectors · method · findings with reproducing input · life-cycle integration). It is a name tag on what this skill already
+produces, not a new check; crosswalk: `knowledge/shared/harness-core/iso_ai_standards_crosswalk.md §2`.
+
 🟥 **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
@@ -238,8 +300,10 @@ floor-tier sims), which is why it is stated here instead of left to the reader t
 
 ⚠️ **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.
+⚠️ **Residency still governs**: a marker can name company assets. Run Step 4.5's screen against the
+marker file too, not just the diff — the marker is not exempt because it is metadata. (This line was
+pure prose until 2026-09-05; Step 4.5 above is what closes it — the scan itself still carries the
+named, unclosed gaps in its own header, so "screened" is not "guaranteed safe".)
 
 *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,
@@ -290,6 +354,22 @@ rejected at commit time.
 | — | change is not load-bearing — decorrelation not required | `single-family` | — |
 | — | **panel never probed** | `UNKNOWN` | **required** |
 
+🟥 **Rungs 1–2's `panel(<families>)` additionally require a `residency=CLEAN(...)` token inside the
+same grounds string, since 2026-09-05** (Step 4.5 above; `pre-commit`'s `validate_crossfamily_leg`
+blocks a bare `panel(...)` with no such token on a marker dated on/after
+`RESIDENCY_TOKEN_GRACE_DATE`). Full grammar:
+
+```
+crossfamily: panel(codex) — residency=CLEAN(files=7) · R1..R2, 4 findings
+crossfamily: DEGRADED_SINGLE_FAMILY — residency=TAINTED(2 files, stripped=no) → not sent, probed codex/agy, 0 reachable
+crossfamily: DEGRADED_SINGLE_FAMILY — residency=NOT_SCANNED(no operator pattern file) → not sent, probed codex/agy, 0 reachable
+```
+
+The token is **optional** on `DEGRADED_*`/`UNKNOWN`/`declined` (format-checked only when present —
+those rungs never claimed anything left the boundary, so nothing to require) and **rejected as a
+contradiction** if `panel(...)` carries `residency=TAINTED(` or `residency=NOT_SCANNED(` on the same
+line — a sent payload and an unscreened/tainted one cannot both be true.
+
 **The three degrade values are the load-bearing split**: *could not* (`DEGRADED_SINGLE_FAMILY`) ·
 *did not* (`DEGRADED_PANEL_UNUSED`) · *did not look* (`UNKNOWN`). Free prose merges all three, and
 each merge hides a different thing — an unrun probe renders as a zero finding
@@ -388,6 +468,11 @@ at N per run (no loop).
   is NOT accepted on a load-bearing change — that block only runs there, so "decorrelation not
   required" is a contradiction, and as a no-ack pass it was a free bypass of the lane.
   *[mandatory-pass — enforced by pre-commit, fixtures `scripts/test_marker_crossfamily_lanes.sh`]*
+- Step 4.5's residency screen ran against the actual send list before any `panel(...)` claim, and
+  its result is recorded as a `residency=CLEAN|TAINTED|NOT_SCANNED(...)` token inside the same
+  `crossfamily:` grounds — required when the value is `panel(...)`, format-checked when present on
+  a degrade value. *[mandatory-pass — enforced by pre-commit since RESIDENCY_TOKEN_GRACE_DATE,
+  fixtures `scripts/test_marker_crossfamily_lanes.sh` `r1`–`r13`]*
 - Panel members are review-capable: embedding/reranker/OCR/safeguard classes are excluded **before**
   family-diversity is counted, never after. *[mandatory-pass — same fixtures, ordering anchor c4/c5]*
 - Paid recruit was per-run spend-gated (or `paid_auto` set); free local tier may auto-fire. *[mandatory-pass]*