genetics-mcp 2.9.1 → 2.9.3

package/skills/genetics-report/assets/generate-illustrations.py

@@ -1,159 +0,0 @@
-#!/usr/bin/env python3
-"""브리프 표를 읽어 그 문서의 일러스트를 만든다.
-
-    python3 generate-illustrations.py --brief <문서>/image-briefs.md --out <폴더>
-
-**이 스크립트는 장면을 모른다.** 장면과 비율은 전부 브리프 표에서 온다.
-그래야 다른 고객사·다른 도메인의 문서에도 같은 스크립트가 쓰인다.
-
-여기 박힌 것은 **스타일 계약**뿐이고, 그 계약은 정본 8장 실측에서 나왔다.
-앞 판들이 실패한 자리를 그대로 적어 둔다 — 지우면 같은 실패가 돌아온다:
-
-  · 장면을 스크립트에 박아 넣어 문서가 바뀌어도 같은 그림이 나왔다(2026-08-16 반려)
-  · 정본을 안 보고 만든 규칙(「큰 면으로」·「표면을 비워라」)이 조형 문법을 지웠다
-  · **한쪽을 비우라고 줬다**(2026-08-17~18 반려). 글이 그림 **위에** 얹힌다고 오독한
-    결과였다. 실제 배치는 하나의 테두리 안에서 글과 그림이 **좌우로 따로** 서는 것이라
-    (계약 4.2절 v1.4) 그림 위에는 아무것도 앉지 않는다 — 비우면 칸의 절반이 죽는다.
-
-판정은 `visual-baseline.py check 그림.png` 로 한다.
-"""
-import argparse
-import os
-import re
-import subprocess
-import sys
-import time
-
-# ── 스타일 계약 — 정본 `image-briefs.md` 「공통 스타일 계약」의 조형 문법을 영어로 옮긴 것.
-# 요약하지 않는다. 요약이 2026-08-17 사고의 시작이었다.
-STYLE = """Flat line illustration in one consistent set. Clean uniform thin dark outlines (#191A23)
-on pure white, with light gray (#F3F3F3) fills. People have black hair, white shirts with a small
-lime accent garment, and simple drawn faces; keep figure proportions identical across the set.
-Build the scene as a small diagram: icons inside outlined circles, connected by dotted and solid
-curved lines, with small badges - a dark circle holding an X, a lime circle holding a check.
-The one accent colour is lime, exactly the hex #B9FF66 - a bright yellow-green highlighter tone,
-much lighter and more yellow than grass green. Never use a darker or duller green, and never wash it
-out toward pale mint, sage or pastel yellow-green: it must stay vivid and fully saturated. Place the
-lime in several small spots - a garment accent, a filled badge, a small figure, a ground shadow -
-never as one large filled area.
-Draw the outlines confidently thick and solid - the line weight of a printed editorial illustration,
-not a faint hairline sketch. The strokes must be clearly heavy, closer to a bold marker than a pencil.
-Add enough elements that the drawing carries real visual weight: extra small dotted connectors, thin
-arcs and tiny diamonds clustered around the main objects.
-Use the light gray fill only inside a few small shapes such as a badge or a single icon body.
-Never fill a background, a panel, a board, a large circle or a garment with gray - those stay pure
-white with an outline. Gray must cover only a small fraction of the picture.
-Draw the people at a readable size: cropped at the waist, each figure about half the frame height,
-with visible hands and facial features. Keep every figure on the SAME side of the frame - never one
-at each edge.
-The drawing reaches across the whole frame - this is not a half-empty picture.
-No text, no numbers, no logos, no watermarks, no photographic or 3D style, no gradients, no neon,
-no fake UI."""
-
-# ── 구도 — 그림은 **자기 칸을 꽉 채운다.**
-#
-# ⚠ 여기 한때 「글이 앉는 쪽 46% 를 연하게 비워 두라」는 문단이 있었다. 글을 그림 위에
-# 얹는 배치를 전제한 것인데, 그 전제가 **오독이었다**(사용자 정정 2026-08-18):
-# 글과 그림은 하나의 테두리 안에서 **좌우로 따로** 선다(계약 4.2절 v1.4).
-# 그림 위에는 아무것도 앉지 않으므로 한쪽을 비울 이유가 없다 — 비우면 칸의 절반이 죽는다.
-COMPOSITION = """Composition: the drawing fills its frame edge to edge as one balanced scene.
-Do not leave one half of the frame empty - there is no text on top of this picture."""
-
-MODEL = 'gpt_image_2'      # 6종 비교에서 유일하게 정본 선화 품질에 도달 (§2.3)
-
-
-def rows(brief):
-    """브리프의 자산 표만 읽는다. 네 번째 칸(배치 쪽)은 사람이 대조할 때만 쓴다."""
-    out = []
-    with open(brief, encoding='utf-8') as fh:
-        for ln in fh:
-            if not ln.startswith('| **'):
-                continue
-            c = [x.strip() for x in ln.strip().strip('|').split('|')]
-            if len(c) < 4:
-                continue
-            name = re.sub(r'\*|\s', '', c[0]).lower().replace('chapter', 'ch')
-            ar = '16:9' if '16:9' in c[1] else '4:3'
-            # 「**왼쪽** — 인물은 오른쪽에」처럼 **한 칸에 두 단어가 다 있다.** 그래서
-            # `in` 으로 찾으면 앞에 쓴 쪽이 이겨 3/7 이 반대로 나간다(2026-08-18 드라이런이
-            # 잡았다 — 그대로 돌렸으면 21크레딧을 버렸다). **굵게 표시된 첫 토큰**만 읽는다.
-            head = re.match(r'\*\*(왼쪽|오른쪽)\*\*', c[3])
-            side = None if not head else ('l' if head.group(1) == '왼쪽' else 'r')
-            out.append((name, ar, c[2], side))
-    return out
-
-
-def gen(name, ar, scene, side, out_dir, ref):
-    dst = os.path.join(out_dir, f'{name}.png')
-    if os.path.exists(dst) and os.path.getsize(dst) > 0:
-        print(f'  [{name}] 이미 있음')
-        return dst
-    # `side` 는 **렌더러가 정하는 배치**(홀수 왼쪽/짝수 오른쪽)라 그림에는 영향이 없다.
-    # 브리프에 남겨 두는 것은 사람이 장 순서를 바꿀 때 대조하기 위해서다.
-    prompt = f'{STYLE}\n\nScene: {scene}\n\n{COMPOSITION}'
-    cmd = ['higgsfield', 'generate', 'create', MODEL, '--wait',
-           '--aspect_ratio', ar, '--resolution', '2k', '--json']
-    if ref:
-        cmd += ['--image', ref]
-    t = time.time()
-    # `rate_limit_reached`(동시 작업 한도 8)는 **기다리면 풀린다.** 재시도가 없던 판은
-    # 3장이 통째로 비었다(2026-08-17) — 교보재에 적혀 있던 함정을 스크립트가 안 지켰다.
-    blob = ''
-    for attempt in range(4):
-        r = subprocess.run(cmd + ['--prompt', prompt], capture_output=True, text=True)
-        blob = (r.stdout or '') + (r.stderr or '')
-        if 'rate_limit_reached' not in blob:
-            break
-        wait = 45 * (attempt + 1)
-        print(f'  [{name}] 한도에 걸렸다 — {wait}초 뒤 재시도 ({attempt + 1}/4)', flush=True)
-        time.sleep(wait)
-    with open(os.path.join(out_dir, f'{name}.json'), 'w', encoding='utf-8') as fh:
-        fh.write(blob)
-    m = re.search(r'https://[^"\s]+\.(?:png|jpg|jpeg|webp)', blob)
-    if not m:
-        print(f'  [{name}] 실패 {time.time() - t:.0f}초: {blob.strip()[:150]}')
-        return None
-    subprocess.run(['curl', '-sL', '-o', dst, m.group(0)], check=True)
-    print(f'  [{name}] 완료 {time.time() - t:.0f}초  {os.path.getsize(dst):,}B', flush=True)
-    return dst
-
-
-def upload_ref(path):
-    u = subprocess.run(['higgsfield', 'upload', 'create', path, '--json'],
-                       capture_output=True, text=True)
-    m = re.search(r'[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}', u.stdout or '')
-    return m.group(0) if m else None
-
-
-def main():
-    ap = argparse.ArgumentParser()
-    ap.add_argument('--brief', required=True, help='그 문서의 image-briefs.md')
-    ap.add_argument('--out', required=True, help='그림을 받을 폴더')
-    ap.add_argument('--only', default='', help='쉼표로 끊은 이름만 만든다 (예: ch02,ch05)')
-    ap.add_argument('--ref', default='', help='세트 참조 UUID. 주면 첫 장을 올리지 않는다')
-    a = ap.parse_args()
-
-    os.makedirs(a.out, exist_ok=True)
-    os.chmod(a.out, 0o700)          # 고객 문서용 그림이다. 남이 읽게 두지 않는다.
-    rs = rows(a.brief)
-    only = {x.strip() for x in a.only.split(',') if x.strip()}
-    print(f'브리프에서 {len(rs)}장을 읽었다 — 스크립트는 장면을 모른다')
-    print('  배치(참고): ' + ' '.join(f'{n}:{s or "-"}' for n, _, _, s in rs))
-
-    ref = a.ref or None
-    for i, (name, ar, scene, side) in enumerate(rs):
-        if only and name not in only:
-            continue
-        p = gen(name, ar, scene, side, a.out, ref)
-        # 첫 장을 세트 기준으로 올린다. **단 관문을 통과한 뒤에.**
-        # 6차에서 hero 의 흐린 라임(#C8E997·거리 55.8)이 참조로 올라가 뒤 6장이 전부
-        # 그 색을 물려받았다 — 참조 UUID 는 첫 장의 결함까지 나른다.
-        if i == 0 and p and not ref and not only:
-            print(f'  ↑ 이 장을 먼저 판정할 것: visual-baseline.py check {p}')
-            ref = upload_ref(p)
-            print(f'  참조 UUID: {ref or "없음(세트 일관성 없이 진행)"}', flush=True)
-    print('끝')
-
-
-if __name__ == '__main__':
-    sys.exit(main())

package/skills/genetics-report/assets/qa.py

@@ -1,198 +0,0 @@
-#!/usr/bin/env python3
-"""산출물 자동 검수. 빌드 직후 반드시 돌린다.
-
-    python3 qa.py report.json
-
-여기서 잡는 것은 **눈으로는 안 보이는 결함**이다. 실제로 이 검사기가 잡아낸 것들:
-  · 강조색을 흰 바탕 글자로 써서 2.25:1 — 화면으로는 "좀 연하네" 정도로만 보인다
-  · 괘선용 회색(--mid)이 본문 색으로 새어 들어감
-  · 건 하나에 "확인 방법" 블록이 빠짐 — 18건 중 1건은 눈으로 못 찾는다
-  · 원고 마커(§)와 내부 티켓 번호가 고객본에 남음
-
-통과 기준: 실패 0. 경고는 판단해서 넘긴다.
-사람이 봐야 하는 것(톤·독자 적합성·실제 렌더)은 이 검사기가 대신하지 못한다 —
-references/qa.md 의 시각 검수 목록을 따로 돌 것.
-"""
-import json, pathlib, re, sys
-
-sys.path.insert(0, str(pathlib.Path(__file__).parent))
-
-# ── palette 는 **레포에서** 가져온다 ────────────────────────────────
-#
-# 예전에는 `assets/` 에 `palette.py` 사본이 있어서 위 한 줄이면 됐다. 2026-08-18 에 그 사본을
-# 지웠고(렌더러의 원본은 레포 하나 — render.py 의 refuse_fork 가 `palette.py` 를 금지 목록에
-# 넣어 두었다), **render.py 는 새 방식으로 갔는데 qa.py 는 안 갔다.** 그래서 이 파일은 그날부터
-# `ModuleNotFoundError: No module named 'palette'` 로 죽어 있었다 — 이 저장소의 어느 커밋에도
-# `assets/palette.py` 가 없다(전 역사 0개, 2026-08-22 확인).
-#
-# 찾는 규칙을 **여기서 새로 쓰지 않는다.** render.py 의 것을 그대로 부른다 —
-# 두 벌로 두면 한쪽만 고쳐져 조용히 갈라진다(GENETICS_REPO 로 덮는 길도 함께 따라온다).
-from render import find_builder, refuse_fork          # noqa: E402  (경로를 넣은 뒤여야 한다)
-
-refuse_fork()                                         # 사본이 다시 생겼으면 여기서 멈춘다
-sys.path.insert(0, str(find_builder().parent))        # <레포>/private/builder
-import palette as P                                   # noqa: E402
-
-FONT_ALLOW = {'Pretendard', 'Pretendard Variable', 'Inter', 'Lora', 'Poppins', 'Georgia',
-              '맑은 고딕', 'Malgun Gothic', 'JetBrains Mono', '구름 산스 코드',
-              '-apple-system', 'BlinkMacSystemFont', 'Apple SD Gothic Neo',
-              'Noto Sans KR', 'system-ui', 'sans-serif', 'serif', 'monospace',
-              'Segoe UI', 'ui-monospace', 'Menlo'}
-
-# 편집 레이어 CSS 가 시작되는 지점. 색 검사에서 이 구간만 도려낸다.
-EDITOR_CSS_MARK = '/* ── 편집 레이어'
-
-SLOP_KO = ['혁신적인', '차세대', '재정의하는', '한 차원 높은', '최적화된 솔루션',
-           '완벽한 경험', '새로운 패러다임', '고도화된']
-
-
-def run(cfg_path):
-    cfg = json.loads(pathlib.Path(cfg_path).read_text(encoding='utf-8'))
-    base = pathlib.Path(cfg_path).parent
-    doc = (base / cfg['out']).read_text(encoding='utf-8')
-    # 편집기 소스는 본문이 아니다 — 검사에서 뺀다
-    body = doc.split('<body', 1)[1].split('<script', 1)[0]
-    text = re.sub(r'<[^>]+>', ' ', body)
-    ok, warn, err = [], [], []
-
-    # 1. 미치환 플레이스홀더
-    ph = re.findall(r'\{[A-Za-z_][^}]{0,40}\}', body)
-    (ok if not ph else err).append(f'플레이스홀더 잔존 {len(ph)}건 {ph[:3] if ph else ""}')
-
-    # 2. 가로 스크롤 유발 고정 폭
-    #    lookbehind 가 없으면 `max-width:1080px` 같은 정상 반응형 코드가 전부 걸린다
-    fixed = re.findall(r'(?<![a-z-])width:\s*\d{3,}px', body)
-    (ok if not fixed else warn).append(f'고정 px 폭 요소 {len(fixed)}건')
-
-    # 3. 색 대비 — 문서에 박힌 :root 를 그대로 읽어 잰다.
-    #    빌드가 유도한 값이 아니라 **실제로 나간 값**을 재는 것이 요점이다.
-    root = re.search(r':root \{(.*?)\n\}', doc, re.S)
-    tok = dict(re.findall(r'--([a-z-]+):\s*([^;]+);', root.group(1))) if root else {}
-    if not tok:
-        err.append(':root 토큰을 찾지 못함')
-    else:
-        for name, fg, bg, r, need, good in P.audit(tok):
-            (ok if good else err).append(f'대비 {name}: {r}:1 (기준 {need})')
-
-    # 4. 괘선 전용 색이 글자로 샜는가
-    # `border-color:var(--mid)` 는 괘선이라 정상 — 앞에 하이픈이 오면 제외한다
-    leak = re.findall(r'(?<![a-z-])color:\s*var\(--mid\)', doc)
-    (ok if not leak else err).append(f'--mid 를 글자색으로 사용 {len(leak)}건')
-    # `border-left-color:var(--accent)` 는 괘선이라 정상이다 — 앞에 하이픈이 오면 제외
-    leak2 = re.findall(r'(?<![-a-z])color:\s*var\(--accent\)(?![-a-z])', doc)
-    (ok if not leak2 else err).append(f'--accent 를 글자색으로 사용 {len(leak2)}건 (배경 전용)')
-
-    # 4-b. 팔레트 밖 하드코딩 색 — 인라인 SVG 와 인쇄용 각주가 새는 자리다.
-    #      편집기 UI 는 문서 활자와 색 계열을 일부러 분리하므로 그 구간만 도려낸다.
-    i, j = doc.find(EDITOR_CSS_MARK), doc.find('</style>', doc.find(EDITOR_CSS_MARK))
-    if i < 0:
-        warn.append(f'편집기 CSS 마커 «{EDITOR_CSS_MARK}» 를 못 찾음 — 색 검사 범위 확인 필요')
-        scan = doc
-    else:
-        scan = doc[:i] + doc[j:]
-    scan = re.sub(r'base64,[A-Za-z0-9+/=]+', 'base64,', scan)   # 폰트 페이로드만 지운다
-    #   ↑ split 으로 자르면 문서 대부분이 함께 날아가 검사가 무의미해진다. 실제로 그랬다.
-    hexes = set()
-    for h3 in re.findall(r'#([0-9a-fA-F]{3})\b(?![0-9a-fA-F])', scan):
-        hexes.add(''.join(c * 2 for c in h3).upper())
-    hexes |= {x.upper() for x in re.findall(r'#([0-9a-fA-F]{6})\b', scan)}
-    allowed = {v.lstrip('#').upper() for v in tok.values() if v.startswith('#')} | {'FFFFFF', '000000'}
-    stray = sorted(hexes - allowed)
-    (ok if not stray else warn).append(f'팔레트 밖 하드코딩 색 {stray or "없음"}')
-    rgba = re.findall(r'rgba?\([^)]*\)', scan)
-    (ok if not rgba else warn).append(f'rgb/rgba 리터럴 {len(rgba)}건 (팔레트 대조 불가)')
-
-    # 5. 폰트 화이트리스트
-    fams = set()
-    for m in re.finditer(r'font-family:([^;}]+)', doc):
-        for f in m.group(1).split(','):
-            fams.add(f.strip().strip('"\''))
-    bad = {f for f in fams if f and f not in FONT_ALLOW}
-    (ok if not bad else warn).append(f'비표준 폰트 {sorted(bad) or "없음"}')
-
-    # 6. 폰트 임베드
-    if cfg.get('font', {}).get('embed', True):
-        m = re.search(r'@font-face \{[^}]*format\("([^"]+)"\)', doc)
-        (ok if m else err).append('@font-face 임베드 존재')
-        if m:
-            (ok if m.group(1) == 'woff2' else err).append(
-                f'format 문자열 "{m.group(1)}" (woff2 여야 함 — 다른 값은 조용히 무시된다)')
-
-    # 7. 구조 일관성 — 모든 건이 같은 구성요소를 갖는가
-    n = len(re.findall(r'<article class="case"', body))
-    for pat, label, adj in [(r'class="num"', '절 번호', 0),
-                            (r'class="row r-sym"', '증상', 0),
-                            (r'class="row r-cause"', '원인', 0),
-                            (r'class="row r-fix"', '조치', 0),
-                            (r'class="row r-check"', '확인 방법', 0)]:
-        c = len(re.findall(pat, body)) - adj
-        (ok if c == n else err).append(f'{label} {c}/{n}')
-    # 뺄셈으로 세지 않는다. 범례는 **실제 쓰인 등급만** 렌더하므로 선언 개수를 빼면
-    # 어떤 등급이 0건일 때 조용히 틀린다. 세는 자리를 좁히면 틀어질 것이 없다.
-    chips = sum(x.count('class="method ')
-                for x in re.findall(r'<div class="case-top">.*?</div>', body, re.S))
-    (ok if chips == n else err).append(f'건별 확인 등급 칩 {chips}/{n}')
-    used = len({c for c in re.findall(r'<td class="c-m"><span class="method [a-z-]+">([^<]+)<', body)})
-    legend_n = len(re.findall(r'<div class="lg">', body))
-    (ok if legend_n == used else err).append(f'범례 항목 {legend_n}/{used} (실제 쓰인 등급 수)')
-
-    # 8. 목차·판정표가 본문과 일치하는가 (편집기가 재생성하기 전 초기 상태)
-    toc_n = len(re.findall(r'<li><a href="#s\d+-\d+"', doc))
-    (ok if toc_n == n else err).append(f'목차 항목 {toc_n}/{n}')
-    v_n = len(re.findall(r'<td class="c-sec">', body))
-    (ok if v_n == n else err).append(f'판정표 행 {v_n}/{n}')
-
-    # 9. 절 참조 링크가 실제 존재하는 절을 가리키는가 (죽은 링크는 검수자를 헤매게 한다)
-    ids = set(re.findall(r'id="(s\d+-\d+)"', body))
-    dead = sorted({h for h in re.findall(r'href="#(s\d+-\d+)"', doc)} - ids)
-    (ok if not dead else err).append(f'죽은 절 참조 {dead or "없음"}')
-
-    # 10. 고객본 원칙
-    (ok if '§' not in doc else err).append(f'원고 마커 § {doc.count("§")}건')
-    for pat in cfg.get('forbid', []):
-        hits = re.findall(pat, doc)
-        (ok if not hits else err).append(f'금지 표현 /{pat}/ {len(hits)}건')
-
-    # 11. 카피 게이트 — 대시 대비 헤드라인 / AI 슬롭
-    heads = [re.sub(r'<[^>]+>', '', x).strip()
-             for x in re.findall(r'<h[123][^>]*>(.*?)</h[123]>', body, re.S)]
-    dash = [h for h in heads if ' — ' in h or ' – ' in h]
-    (ok if not dash else err).append(f'대시 대비 헤드라인 {dash or "없음"}')
-    slop = [s for s in SLOP_KO if s in text]
-    (ok if not slop else err).append(f'AI 슬롭 어휘 {slop or "없음"}')
-
-    # 12. 접근성 · 단일 파일
-    (ok if f'lang="{cfg.get("lang", "ko")}"' in doc else err).append('lang 선언')
-    imgs = re.findall(r'<img(?![^>]*\balt=)[^>]*>', body)
-    (ok if not imgs else err).append(f'alt 없는 <img> {len(imgs)}건')
-    allow = cfg.get('allow_external', [])
-    ext = [u for u in re.findall(r'(?:src|href)="(https?://[^"]+)"', doc)
-           if not any(a in u for a in allow)]
-    (ok if not ext else err).append(f'외부 리소스 {ext[:3] or "없음"}')
-
-    # 13. 고객본 내보내기 시뮬레이션 — editor.js 의 serialize(customer=true) 와 같은 규칙
-    #     표식을 안 붙이면 내보내기 코드는 **조용히 아무것도 못 지운다**. 실제로 그랬다.
-    cust = re.sub(r'<!-- REPORT-EDITOR:BEGIN -->.*?<!-- REPORT-EDITOR:END -->', '', doc, flags=re.S)
-    cust = re.sub(r'<(style|script)\b[^>]*\bdata-rte-src\b.*?</\1>', '', cust, flags=re.S)
-    cust = re.sub(r'\sdata-report-edit="[^"]*"', '', cust, count=1)   # body 속성 제거
-    cust = re.sub(r'<[^>]*\bdata-internal="true".*?</\w+>', '', cust, flags=re.S)
-    residue = [w for w in ('data-rte-ui', 'showSaveFilePicker', 'syncVerdict',
-                           'data-report-edit', 'data-internal="true"') if w in cust]
-    (ok if not residue else err).append(f'고객본에 남는 편집기 흔적 {residue or "없음"}')
-    (ok if len(cust) < len(doc) * 0.98 else err).append(
-        f'고객본 크기 {len(cust.encode()):,}B (원본 대비 {len(cust)/len(doc):.0%})')
-
-    size = len(doc.encode())
-    print(f'■ QA — {cfg["out"]}  {size:,}B  건수 {n}\n')
-    for x in err:
-        print('  ❌', x)
-    for x in warn:
-        print('  ⚠️ ', x)
-    for x in ok:
-        print('  ✅', x)
-    print(f'\n통과 {len(ok)} · 경고 {len(warn)} · 실패 {len(err)}')
-    return 1 if err else 0
-
-
-if __name__ == '__main__':
-    sys.exit(run(sys.argv[1] if len(sys.argv) > 1 else 'report.json'))