voidlight00/dptd-harness/kami-svg-diagrams

Kami SVG Diagrams

14종 매칭 룰

알고리즘

1. 본문 섹션별 트리거 키워드 스캔
2. confidence ≥ 0.6 후보만 생성
3. 한 섹션당 최대 1개
4. 본문에 이미 같은 정보가 표/리스트로 있으면 다이어그램 우선 + 표는 캡션으로 보조

스타일 룰 (모든 SVG 공통)

허용 색상:

• #f5f4ed (parchment, 배경)
• #1B365D (brand, 단일 강조)
• #E4ECF5 (brand-tint-strong, 채움)
• #141413, #3d3d3a, #504e49, #6b6a64 (warm gray scale)
• #e8e6dc, #e5e3d8 (border)

금지:

• 다중 chromatic (red/green/yellow 추가)
• <linearGradient>, <radialGradient>
• filter 기반 hard drop shadow
• font-style="italic"
• font-weight="bold" (500 고정, label은 600)
• rgba(), hsla()

허용 깊이 표현:

• 1pt ring stroke (stroke="#e8e6dc" stroke-width="1")
• 잉크블루 단일 강조 (CTA 영역, primary 노드, primary edge)
• 따뜻한 그레이 스케일로 데이터 위계

폰트

<text font-family="Noto Serif KR, Charter, Georgia, serif"
      font-weight="500"
      font-size="11"
      fill="#141413">텍스트</text>

systemfont 우선 (WeasyPrint PDF 외부 fetch 부담 최소화).

diagrams.manifest.json 스키마

{
  "run_id": "<run_id>",
  "diagrams": [
    {
      "id": "d-01",
      "type": "architecture",
      "file": "d-01-architecture.svg",
      "anchor_heading": "## 시스템 구조",
      "insert_after_line": 42,
      "confidence": 0.85,
      "caption": "코깍지알 그룹챗 협업 구조",
      "source_section_lines": [38, 60],
      "data_extracted": {
        "nodes": ["봇", "사용자A", "사용자B"],
        "edges": [["사용자A","봇"],["봇","사용자B"]]
      }
    }
  ]
}

안전 룰

• mockup 수치 / 가짜 데이터 절대 금지 — 본문에 실제 데이터 없으면 다이어그램 생성 안 함
• numeric 정확도 유지 + 텍스트 라벨로 정확 값 동반
• 다이어그램 생성 실패 시 silent fallback (원본 표/리스트 유지)
• PDF 1개당 다이어그램 8개 초과 시 conductor에 시각 과부하 경고
• WeasyPrint 호환 인라인 SVG만 (<img src="..."> 외부 참조 금지)

Reference

각 14종 다이어그램의 SVG 템플릿 사양은 upstream Kami references/diagrams.md (19,587 byte) 참조. 필요 시 gh api repos/tw93/kami/contents/references/diagrams.md --jq .content | base64 -d 로 fetch.