Upload 9 files

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+core.cpython-312-x86_64-linux-gnu.so filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -0,0 +1,21 @@
+FROM python:3.12-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    zip nodejs npm && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY core.cpython-312-x86_64-linux-gnu.so ./
+COPY engine.dat app.py index.html sample_hanji.hwpx ./
+COPY emergence_matrix_document.json ./
+COPY hwpx_templates/ ./hwpx_templates/
+
+# 검증
+RUN python -c "from core import soma_pipeline, generate_hwpx, hwpx_to_html_preview; print('✅ core.so 검증 통과')"
+
+EXPOSE 7860
+CMD ["python", "app.py"]

README.md

@@ -1,14 +1,10 @@
 ---
-title: Hwp Agent
-emoji: 🐢
-colorFrom: blue
-colorTo: yellow
-sdk: gradio
-sdk_version: 6.9.0
-app_file: app.py
-pinned: false
-license: apache-2.0
-short_description: hwp-agent
+title: HWP-Agent
+emoji: 📄
+colorFrom: indigo
+colorTo: green
+sdk: docker
+app_port: 7860
+pinned: true
 ---
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 한지(HANJI) · On-Premise HWP AI Agent

app.py

@@ -0,0 +1,634 @@
+# ============================================================
+#  한지(HANJI) · HWP AI Agent — Application Server
+#  core.py (또는 core.so) 에서 엔진 로드
+# ============================================================
+import os, re, json, tempfile, threading, zipfile
+from pathlib import Path
+
+import gradio as gr
+
+# ── 핵심 엔진 로드 (core.py 또는 core.so) ──
+from core import (
+    soma_pipeline,
+    generate_hwpx,
+    hwpx_to_html_preview,
+    process_uploaded_file,
+    normalize_text_for_title,
+    ohaeng_cards_html,
+    analyze_hwpx_styles,
+    page_guard_check,
+    doc_chat_respond,
+    _viewer_empty,
+    _viewer_empty_fullpage,
+    _install_hwpjs,
+    _is_binary_hwp,
+    _HWPJS_READY,
+    _HWP_CONVERT_GUIDE,
+    FIREWORKS_API_KEY,
+    FIREWORKS_MODEL,
+    FIREWORKS_URL,
+    DOC_CHAT_SYSTEM,
+)
+import requests  # chat API에서 사용
+
+# ============================================================
+# ⑦ Gradio UI  — v7 HANJI · Single-Page HWP Viewer Style
+# ============================================================
+
+# ── 기본 샘플 문서 (서비스 시작 시 뷰어에 표시) ──
+_SAMPLE_HWPX = os.path.join(os.path.dirname(os.path.abspath(__file__)), "sample_hanji.hwpx")
+_SAMPLE_PREVIEW = ""
+if os.path.exists(_SAMPLE_HWPX):
+    try:
+        _SAMPLE_PREVIEW = hwpx_to_html_preview(_SAMPLE_HWPX)
+        print(f"✅ 기본 샘플 미리보기 로드: sample_hanji.hwpx ({os.path.getsize(_SAMPLE_HWPX):,}B)")
+    except Exception as _se:
+        print(f"⚠️ 샘플 미리보기 실패: {_se}")
+if not _SAMPLE_PREVIEW:
+    _SAMPLE_PREVIEW = _viewer_empty_fullpage("문서를 생성하거나 레퍼런스를 업로드하면 여기에 표시됩니다.")
+
+SOMA_CUSTOM_CSS = """
+@keyframes pulse{0%,100%{opacity:1;transform:scale(1)}50%{opacity:.4;transform:scale(.8)}}
+.soma-topbar{display:flex;align-items:center;gap:10px;padding:8px 16px;
+  background:#fff;border:1px solid #e8ecf1;border-radius:12px;margin-bottom:8px;}
+.soma-logo{font-weight:900;font-size:15px;color:#1e1b4b;}
+.soma-logo em{font-style:normal;font-weight:400;font-size:11px;color:#475569;margin-left:2px;}
+.soma-sep{width:1px;height:18px;background:#e8ecf1;}
+.soma-desc{font-size:11px;color:#475569;font-weight:500;}
+.soma-url{display:inline-flex;align-items:center;gap:4px;padding:3px 12px;border-radius:20px;
+  font-family:monospace;font-size:9.5px;font-weight:600;
+  background:linear-gradient(135deg,#4f46e5,#4338ca);color:#fff;text-decoration:none;
+  box-shadow:0 2px 8px rgba(79,70,229,.2);}
+.soma-url:hover{box-shadow:0 4px 14px rgba(79,70,229,.35);}
+.soma-right{margin-left:auto;display:flex;align-items:center;gap:8px;}
+.soma-contact{display:inline-flex;align-items:center;gap:4px;padding:3px 10px;border-radius:20px;
+  font-family:monospace;font-size:8.5px;font-weight:600;color:#0d9488;
+  background:rgba(13,148,136,.06);border:1px solid rgba(13,148,136,.12);text-decoration:none;}
+button.primary{background:linear-gradient(135deg,#6366f1,#4f46e5)!important;border:none!important;
+  box-shadow:0 4px 12px rgba(99,102,241,.25)!important;font-weight:700!important;border-radius:10px!important;}
+button.primary:hover{box-shadow:0 6px 20px rgba(99,102,241,.35)!important;}
+.viewer-panel{min-height:700px;}
+.viewer-panel .gr-html{min-height:680px;}
+"""
+
+def build_ui():
+    with gr.Blocks(title="한지(HANJI) · HWP AI Agent 서비스") as app:
+
+        gr.HTML(f"<style>{SOMA_CUSTOM_CSS}</style>")
+
+        # ── Top Bar ──
+        gr.HTML("""
+<div class="soma-topbar">
+  <span class="soma-logo">한지<em>(HANJI)</em></span>
+  <span class="soma-sep"></span>
+  <span class="soma-desc">HWP AI Agent 서비스</span>
+  <a class="soma-url" href="https://hanji.ginigen.ai" target="_blank">🔗 hanji.ginigen.ai</a>
+  <span class="soma-right">
+    <a class="soma-contact" href="mailto:ginigenaihp@gmail.com">📧 문의 · 온프레미스 · 제휴</a>
+  </span>
+</div>""")
+
+        # ── States ──
+        ref_text_state = gr.State("")
+        ref_hwpx_path_state = gr.State("")
+        state = gr.State({"final_doc": "", "search_count": 0})
+        dummy_state = gr.State("")
+        doc_text_state = gr.State("")
+
+        # ══════════════════════════════════════════════════
+        #  MAIN LAYOUT: Left 1/3 Controls  |  Right 2/3 Viewer
+        # ══════════════════════════════════════════════════
+        with gr.Row(equal_height=False):
+
+            # ── LEFT PANEL (1/3) ──────────────────────────
+            with gr.Column(scale=1, min_width=320):
+
+                # Prompt
+                prompt_input = gr.Textbox(
+                    label="📌 프롬프트",
+                    placeholder="예: 2026년 AI 보안 유망기업 육성 지원사업 공모 안내문을 작���해주세요.",
+                    lines=3)
+
+                # File upload
+                ref_file_upload = gr.File(
+                    label="📎 레퍼런스 문서",
+                    file_types=[".hwp",".hwpx",".hml",".pdf",".docx",".txt",".md",
+                                ".csv",".json",".xml",".xlsx",".xls",".py",".html",".log"])
+                ref_upload_status = gr.Textbox(label="파일 상태", interactive=False, lines=2,
+                    placeholder="레퍼런스 파일을 업로드하면 여기에 상태가 표시됩니다.")
+
+                # Settings (compact)
+                with gr.Row():
+                    max_search_slider = gr.Slider(minimum=5, maximum=100, value=20, step=5,
+                        label="🔍 검색", scale=1)
+                    temperature_slider = gr.Slider(minimum=0.1, maximum=1.0, value=0.6, step=0.05,
+                        label="🌡 Temp", scale=1)
+
+                # Action buttons
+                with gr.Row():
+                    run_btn = gr.Button("🚀 문서 생성", variant="primary", scale=2)
+                    stop_btn = gr.Button("⛔", variant="secondary", scale=0)
+
+                # Status indicator
+                search_counter = gr.Markdown("대기 중")
+
+                # HWPX Download
+                with gr.Row():
+                    gen_hml_btn = gr.Button("📥 HWPX 변환", variant="primary", scale=2)
+                    copy_text_btn = gr.Button("📋", variant="secondary", scale=0)
+                hml_status = gr.Textbox(label="", interactive=False, value="",
+                    placeholder="HWPX 변환 상태", lines=1)
+                hml_file = gr.File(label="다운로드", file_types=[".hwpx"], visible=True)
+
+                # Generated text (collapsed)
+                with gr.Accordion("📝 생성된 텍스트", open=False):
+                    final_doc_box = gr.Textbox(label="", value="", interactive=True, lines=12,
+                        placeholder="SOMA 파이프라인 실행 후 최종 문서 텍스트")
+
+                # Pipeline internals (collapsed)
+                with gr.Accordion("🧬 파이프라인 로그", open=False):
+                    agent_stream = gr.Textbox(label="Agent Stream", value="", interactive=False, lines=6)
+                    search_log_box = gr.Textbox(label="Search Log", value="", interactive=False, lines=4)
+                    agent_log_box = gr.Textbox(label="Pipeline Log", value="", interactive=False, lines=6)
+
+                # Doc Chat (collapsed)
+                with gr.Accordion("📎 문서 분석 챗", open=False):
+                    doc_upload = gr.File(label="📄 문서 업로드",
+                        file_types=[".hwp",".hwpx",".hml",".pdf",".docx",".txt",".md",
+                                    ".csv",".json",".xml",".xlsx",".xls",".py",".html",".log"])
+                    doc_upload_status = gr.Textbox(label="", interactive=False, lines=1)
+                    doc_chatbot = gr.Chatbot(label="💬 Chat", height=200)
+                    with gr.Row():
+                        doc_msg = gr.Textbox(label="", placeholder="질문하세요...", lines=1, scale=4)
+                        doc_send_btn = gr.Button("🚀", variant="primary", scale=0)
+                    doc_clear_btn = gr.Button("🗑️ Clear", size="sm")
+
+            # ── RIGHT PANEL (2/3) — DOCUMENT VIEWER ──────
+            with gr.Column(scale=2, min_width=500, elem_classes=["viewer-panel"]):
+                viewer_main = gr.HTML(value=_SAMPLE_PREVIEW)
+
+        # ── Hidden component for ohaeng (pipeline needs it) ──
+        ohaeng_display = gr.HTML(value="", visible=False)
+
+        # ── Event Handlers
+        def handle_ref_upload(file):
+            if file is None:
+                return "", "", "", _viewer_empty("파일을 선택하면 여기에 미리보기가 표시됩니다.")
+            fpath = file.name if hasattr(file, 'name') else str(file)
+            fname = os.path.basename(fpath)
+            ext = Path(fpath).suffix.lower()
+
+            # ── 바이너리 HWP 감지 → 변환 안내 ──
+            if ext == '.hwp' and _is_binary_hwp(fpath):
+                text, err = process_uploaded_file(fpath)
+                preview = hwpx_to_html_preview(fpath)
+                if text:
+                    status = f"📄 {fname} ({len(text):,}자 추출)\n\n{_HWP_CONVERT_GUIDE}"
+                    return text, status, "", preview
+                return "", f"❌ {fname}: {err}", "", preview
+
+            # ── HWPX 파일 → 스타일 복원 모드 ──
+            hwpx_path = ""
+            if ext == '.hwpx':
+                try:
+                    with zipfile.ZipFile(fpath, 'r') as zf:
+                        if 'Contents/header.xml' in zf.namelist():
+                            hwpx_path = fpath
+                            styles = analyze_hwpx_styles(fpath)
+                            print(f"📋 레퍼런스 HWPX 분석 완료: charPr {styles['char_count']}개, "
+                                  f"paraPr {styles['para_count']}개, "
+                                  f"borderFill {styles['bf_count']}개")
+                except:
+                    pass
+
+            # ── 그 외 파일 ──
+            text, err = process_uploaded_file(fpath)
+            # 뷰어: HWP/HWPX만 렌더링
+            if ext in ('.hwp', '.hwpx'):
+                preview = hwpx_to_html_preview(fpath)
+            else:
+                preview = _viewer_empty(f"{fname} — HWP/HWPX 파일만 미리보기 지원됩니다.")
+            if text:
+                status = f"✅ {fname} ({len(text):,}자)"
+                if hwpx_path:
+                    status += " 🎯 HWPX 스타일 복원 모드 활성"
+                    status += "\n💡 원본 서식만 사용, 내용은 프롬프트 주제로 새로 생성됩니다"
+                return text, status, hwpx_path, preview
+            return "", f"❌ {fname}: {err}", "", preview
+
+        ref_file_upload.change(fn=handle_ref_upload, inputs=[ref_file_upload],
+                               outputs=[ref_text_state, ref_upload_status, ref_hwpx_path_state, viewer_main])
+
+        def run_soma(prompt, max_search, temperature, ref_text, ref_hwpx_path=""):
+            if not prompt.strip():
+                yield (ohaeng_cards_html("水"), "⚠️ 프롬프트를 입력하세요.", "", "", "", "대기 중", "")
+                return
+
+            full_prompt = prompt
+            if ref_text and ref_text.strip():
+                # HWPX 레퍼런스가 있으면 → 서식 전용, AI 프롬프트에 원본 내용 미주입
+                # (SectionCloner가 서식을 처리하므로 내용은 프롬프트 주제만으로 생성)
+                if ref_hwpx_path and os.path.exists(ref_hwpx_path):
+                    # HWPX 모드: 서식 구조 힌트만 간략히 추가
+                    full_prompt = (
+                        f"{prompt}\n\n"
+                        f"[서식 참고: 공문서 형식으로 작성. "
+                        f"# 제목, ## Ⅰ.~Ⅴ. 섹션, ### 소항목, □ 핵심항목, ○ 세부사항, "
+                        f"| 표 | 형식을 활용하여 체계적으로 구성할 것]"
+                    )
+                else:
+                    # 일반 파일(PDF/TXT 등): 참고자료로 활용
+                    ref_content = ref_text.strip()[:8000]
+                    full_prompt = f"{prompt}\n\n[참고자료]\n{ref_content}"
+
+            stream_acc, log_acc, search_log, final_doc = "", "", "", ""
+            active_agent, sc = "水", 0
+
+            for chunk in soma_pipeline(full_prompt, int(max_search), temperature):
+                if chunk.get("done"):
+                    final_doc = chunk.get("final_doc", "")
+                    sc = chunk.get("search_count", sc)
+                    log_acc = chunk.get("log", "")
+                    search_log = chunk.get("search_log", "")
+                    break
+
+                active_agent = chunk.get("active", active_agent)
+                tok = chunk.get("stream", "")
+                if tok:
+                    stream_acc += tok
+                    if len(stream_acc) > 8000:
+                        stream_acc = "...(이전 생략)...\n" + stream_acc[-6000:]
+
+                if chunk.get("log"): log_acc = chunk["log"]
+                if chunk.get("search_log"): search_log = chunk["search_log"]
+                if chunk.get("search_count") is not None: sc = chunk["search_count"]
+                if chunk.get("final_doc"): final_doc = chunk["final_doc"]
+
+                yield (ohaeng_cards_html(active_agent), stream_acc, search_log, log_acc,
+                       final_doc if final_doc else "", f"🔍 {sc} / {int(max_search)}", "")
+
+            yield (ohaeng_cards_html("金"), stream_acc + "\n\n🎉 완료!", search_log, log_acc,
+                   final_doc, f"✅ 완료: {sc}회 검색", final_doc)
+
+        run_btn.click(
+            fn=run_soma,
+            inputs=[prompt_input, max_search_slider, temperature_slider, ref_text_state, ref_hwpx_path_state],
+            outputs=[ohaeng_display, agent_stream, search_log_box, agent_log_box, final_doc_box, search_counter, dummy_state])
+
+        def make_hml(doc_text, ref_hwpx_path):
+            if not doc_text or not doc_text.strip():
+                return None, "❌ 문서를 먼저 생성하세요.", _viewer_empty("HWPX 생성 후 여기에 표시됩니다.")
+            try:
+                # 레퍼런스 HWPX가 있으면 스타일 복원 모드
+                if ref_hwpx_path and os.path.exists(ref_hwpx_path):
+                    path = generate_hwpx(doc_text.strip(), ref_hwpx_path=ref_hwpx_path)
+                    mode = "🎯 레퍼런스 스타일 복원"
+                else:
+                    path = generate_hwpx(doc_text.strip())
+                    mode = "📄 report 템플릿"
+
+                title = normalize_text_for_title(doc_text.strip())
+                safe_title = re.sub(r'[\\/:*?"<>|]', '', title)[:40].strip() or "문서"
+                new_path = os.path.join(os.path.dirname(path), f"{safe_title}.hwpx")
+                os.rename(path, new_path)
+
+                # page_guard 결과 표시
+                status = f"✅ 생성 완료 ({mode})"
+                if ref_hwpx_path and os.path.exists(ref_hwpx_path):
+                    guard = page_guard_check(ref_hwpx_path, new_path)
+                    if guard["status"] == "PASS":
+                        status += f" | 📏 page_guard PASS (ref={guard['ref_chars']}자 → out={guard['out_chars']}자)"
+                    else:
+                        status += f" | ⚠️ page_guard {len(guard['errors'])}건 경고"
+
+                # 생성된 HWPX 뷰어 렌더링
+                preview = hwpx_to_html_preview(new_path)
+                return new_path, status, preview
+
+            except Exception as e:
+                return None, f"❌ 오류: {e}", _viewer_empty(f"생성 오류: {e}")
+
+        gen_hml_btn.click(fn=make_hml, inputs=[final_doc_box, ref_hwpx_path_state],
+                          outputs=[hml_file, hml_status, viewer_main])
+
+        # Doc Chat handlers
+        def handle_doc_upload(file):
+            if file is None:
+                return "", "파일을 선택해주세요."
+            fpath = file.name if hasattr(file, 'name') else str(file)
+            fname = os.path.basename(fpath)
+            ext = Path(fpath).suffix.lower()
+
+            # 바이너리 HWP 감지
+            is_bin_hwp = (ext == '.hwp' and _is_binary_hwp(fpath))
+
+            text, err = process_uploaded_file(fpath)
+            if text:
+                status = f"✅ {fname} ({len(text):,}자)"
+                if is_bin_hwp:
+                    status = f"📄 {fname} ({len(text):,}자 추출) — 바이너리 HWP (텍스트만 추출됨)"
+                return text, status
+            return "", f"❌ {fname}: {err}"
+
+        doc_upload.change(fn=handle_doc_upload, inputs=[doc_upload], outputs=[doc_text_state, doc_upload_status])
+        doc_send_btn.click(fn=doc_chat_respond, inputs=[doc_msg, doc_chatbot, doc_text_state], outputs=[doc_chatbot])
+        doc_msg.submit(fn=doc_chat_respond, inputs=[doc_msg, doc_chatbot, doc_text_state], outputs=[doc_chatbot])
+        doc_clear_btn.click(fn=lambda: ([], ""), outputs=[doc_chatbot, doc_text_state])
+
+    return app
+
+
+# ============================================================
+# ⑧ Entry Point — FastAPI 메인 + Gradio 서브마운트
+# ============================================================
+from fastapi import FastAPI, Request as _FAReq
+from fastapi.responses import FileResponse, JSONResponse, HTMLResponse, StreamingResponse
+import uvicorn
+
+# ── FastAPI 메인 앱 ──
+app = FastAPI()
+
+_APP_DIR    = os.path.dirname(os.path.abspath(__file__))
+_index_path = os.path.join(_APP_DIR, "index.html")
+
+# ── ohah/hwpjs 백그라운드 설치 ──
+threading.Thread(target=_install_hwpjs, daemon=True).start()
+
+
+# ── "/" → index.html 서빙 ──
+@app.get("/")
+async def _serve_index():
+    if os.path.exists(_index_path):
+        return FileResponse(_index_path, media_type="text/html")
+    return HTMLResponse("<h1>index.html not found</h1>", status_code=404)
+
+@app.get("/ui")
+async def _serve_ui():
+    return await _serve_index()
+
+
+# ── SOMA API ──
+import asyncio as _asyncio
+import queue as _queue
+
+_file_registry = {}
+_doc_text_store = {}  # sid → text
+
+@app.post("/soma/run")
+async def _soma_run(req: _FAReq):
+    try:
+        body = await req.json()
+        prompt      = body.get("prompt", "").strip()
+        max_search  = int(body.get("max_search", 20))
+        temperature = float(body.get("temperature", 0.6))
+        ref_text    = body.get("ref_text", "")  # 직접 전달
+        ref_sid     = body.get("ref_sid", "")   # doc-upload에서 받은 sid
+        if not ref_text and ref_sid:
+            ref_text = _doc_text_store.get(ref_sid, "")
+        if not prompt:
+            return JSONResponse({"error": "prompt 없음"}, status_code=400)
+
+        # 레퍼런스 텍스트가 있으면 프롬프트에 추가
+        full_prompt = prompt
+        if ref_text and ref_text.strip():
+            ref_snippet = ref_text.strip()[:8000]
+            full_prompt = f"{prompt}\n\n[참고자료]\n{ref_snippet}"
+
+        # 동기 제너레이터를 별도 스레드에서 실행 → 이벤트 루프 블로킹 방지
+        q = _queue.Queue()
+
+        def _run_in_thread():
+            try:
+                for chunk in soma_pipeline(full_prompt, max_search, temperature):
+                    q.put(json.dumps(chunk, ensure_ascii=False))
+            except Exception as e:
+                q.put(json.dumps({"error": str(e), "done": True}))
+            finally:
+                q.put(None)  # 종료 시그널
+
+        threading.Thread(target=_run_in_thread, daemon=True).start()
+
+        async def _async_generate():
+            while True:
+                # 큐에서 비동기로 가져오기 (이벤트 루프 블로킹 없음)
+                try:
+                    item = await _asyncio.get_event_loop().run_in_executor(
+                        None, lambda: q.get(timeout=300))
+                except:
+                    break
+                if item is None:
+                    yield "data: [DONE]\n\n"
+                    break
+                yield f"data: {item}\n\n"
+
+        return StreamingResponse(_async_generate(),
+                                 media_type="text/event-stream",
+                                 headers={"Cache-Control": "no-cache",
+                                          "X-Accel-Buffering": "no"})
+    except Exception as e:
+        return JSONResponse({"error": str(e)}, status_code=500)
+
+
+
+@app.post("/soma/hml")
+async def _soma_hml(req: _FAReq):
+    try:
+        body = await req.json()
+        content = body.get("content", "").strip()
+        if not content:
+            return JSONResponse({"error": "content 없음"}, status_code=400)
+
+        def _blocking():
+            path = generate_hwpx(content)
+            title = normalize_text_for_title(content)
+            safe  = re.sub(r'[\\/:*?"<>|]', '', title)[:40].strip() or "문서"
+            new_path = os.path.join(os.path.dirname(path), f"{safe}.hwpx")
+            os.rename(path, new_path)
+            return new_path
+
+        new_path = await _asyncio.get_event_loop().run_in_executor(None, _blocking)
+        fname = os.path.basename(new_path)
+        _file_registry[fname] = new_path
+
+        return JSONResponse({"file_url": f"/file/{fname}",
+                              "filename": fname,
+                              "file_path": new_path})
+    except Exception as e:
+        return JSONResponse({"error": str(e)}, status_code=500)
+
+
+@app.get("/file/{fname}")
+async def _serve_file(fname: str):
+    fpath = _file_registry.get(fname)
+    if fpath and os.path.exists(fpath):
+        return FileResponse(fpath, filename=fname,
+                            media_type="application/octet-stream")
+    return JSONResponse({"error": "파일 없음"}, status_code=404)
+
+
+@app.post("/soma/preview")
+async def _soma_preview(req: _FAReq):
+    try:
+        body = await req.json()
+        if "b64" in body:
+            import base64 as _b64
+            ext  = body.get("ext", ".hwpx").lower()
+            tmp  = tempfile.NamedTemporaryFile(suffix=ext, delete=False)
+            tmp.write(_b64.b64decode(body["b64"]))
+            tmp.close()
+            fpath = tmp.name
+        else:
+            fpath = body.get("file_path", "")
+
+        if not fpath or not os.path.exists(fpath):
+            return HTMLResponse(_viewer_empty("파일을 찾을 수 없습니다."))
+
+        preview = await _asyncio.get_event_loop().run_in_executor(
+            None, hwpx_to_html_preview, fpath)
+        return HTMLResponse(preview)
+    except Exception as e:
+        return HTMLResponse(_viewer_empty(f"미리보기 오류: {e}"))
+
+
+@app.get("/soma/status")
+async def _soma_status():
+    return JSONResponse({
+        "status": "ok",
+        "hwpjs_ready": _HWPJS_READY,
+        "engine": "ohah/hwpjs WASM" if _HWPJS_READY else "Python lxml"
+    })
+
+# HF Spaces 호환 — 헬스체크
+@app.get("/api/health")
+async def _health():
+    return JSONResponse({"status": "ok"})
+
+
+# ── 문서 업로드 (텍스트 추출) ──
+
+@app.post("/soma/doc-upload")
+async def _soma_doc_upload(req: _FAReq):
+    """업로드된 문서에서 텍스트 추출 (b64 또는 file_path)"""
+    try:
+        body = await req.json()
+
+        fpath = body.get("file_path", "")
+        if not (fpath and os.path.exists(fpath)):
+            import base64 as _b64
+            b64  = body.get("b64", "")
+            fname = body.get("filename", "document")
+            ext   = body.get("ext", ".txt").lower()
+            tmp = tempfile.NamedTemporaryFile(suffix=ext, delete=False)
+            tmp.write(_b64.b64decode(b64))
+            tmp.close()
+            fpath = tmp.name
+
+        text, err = await _asyncio.get_event_loop().run_in_executor(
+            None, process_uploaded_file, fpath)
+
+        if text:
+            sid = str(id(text))[-8:]
+            _doc_text_store[sid] = text
+            return JSONResponse({"ok": True, "sid": sid,
+                                  "chars": len(text),
+                                  "preview": text[:200]})
+        return JSONResponse({"ok": False, "error": err or "텍스트 추출 실패"})
+    except Exception as e:
+        return JSONResponse({"ok": False, "error": str(e)})
+
+
+# ── 문서 QnA 챗 (SSE 스트리밍) ──
+@app.post("/soma/chat")
+async def _soma_chat(req: _FAReq):
+    """문서 기반 QnA 챗 — SSE 스트리밍"""
+    try:
+        body = await req.json()
+        message   = body.get("message", "").strip()
+        sid       = body.get("sid", "")
+        history   = body.get("history", [])
+
+        if not message:
+            return JSONResponse({"error": "message 없음"}, status_code=400)
+        if not FIREWORKS_API_KEY:
+            return JSONResponse({"error": "FIREWORKS_API_KEY 미설정"}, status_code=500)
+
+        doc_text = _doc_text_store.get(sid, "")
+
+        # 메시지 구성
+        if doc_text:
+            user_content = f"## 📄 업로드된 문서 내용\n---\n{doc_text[:12000]}\n---\n\n## 💬 질문\n{message}\n\n위 문서 내용을 바탕으로 답변해주세요."
+        else:
+            user_content = message
+
+        api_messages = [{"role": "system", "content": DOC_CHAT_SYSTEM}]
+        for h in (history or [])[-6:]:
+            if isinstance(h, (list, tuple, dict)):
+                if isinstance(h, dict):
+                    api_messages.append({"role": h.get("role","user"), "content": h.get("content","")})
+                elif len(h) == 2:
+                    api_messages.append({"role": "user", "content": h[0] or ""})
+                    api_messages.append({"role": "assistant", "content": h[1] or ""})
+        api_messages.append({"role": "user", "content": user_content})
+
+        q2 = _queue.Queue()
+
+        def _chat_thread():
+            try:
+                headers = {"Accept":"application/json","Content-Type":"application/json",
+                           "Authorization": f"Bearer {FIREWORKS_API_KEY}"}
+                payload = {"model": FIREWORKS_MODEL, "max_tokens": 16000,
+                           "temperature": 0.6, "stream": True, "messages": api_messages}
+                resp = requests.post(FIREWORKS_URL, headers=headers, json=payload,
+                                     stream=True, timeout=180)
+                resp.raise_for_status()
+                for raw_line in resp.iter_lines():
+                    if not raw_line: continue
+                    line = raw_line.decode("utf-8") if isinstance(raw_line, bytes) else raw_line
+                    if not line.startswith("data: "): continue
+                    data = line[6:]
+                    if data.strip() == "[DONE]":
+                        break
+                    try:
+                        chunk = json.loads(data)
+                        delta = chunk["choices"][0]["delta"].get("content", "")
+                        if delta:
+                            q2.put(json.dumps({"delta": delta}, ensure_ascii=False))
+                    except:
+                        pass
+            except Exception as e:
+                q2.put(json.dumps({"error": str(e)}))
+            finally:
+                q2.put(None)
+
+        threading.Thread(target=_chat_thread, daemon=True).start()
+
+        async def _async_chat():
+            while True:
+                try:
+                    item = await _asyncio.get_event_loop().run_in_executor(
+                        None, lambda: q2.get(timeout=300))
+                except:
+                    break
+                if item is None:
+                    yield "data: [DONE]\n\n"
+                    break
+                yield f"data: {item}\n\n"
+
+        return StreamingResponse(_async_chat(),
+                                 media_type="text/event-stream",
+                                 headers={"Cache-Control": "no-cache",
+                                          "X-Accel-Buffering": "no"})
+    except Exception as e:
+        return JSONResponse({"error": str(e)}, status_code=500)
+
+
+# ── Gradio를 /gradio 서브경로에 마운트 ──
+demo = build_ui()
+app = gr.mount_gradio_app(app, demo, path="/gradio")
+
+print("✅ FastAPI 메인 서버")
+print("   / → index.html")
+print("   /gradio → Gradio UI")
+print("   /soma/* → API")
+
+uvicorn.run(app, host="0.0.0.0", port=7860)

core.cpython-312-x86_64-linux-gnu.so

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:480e7f95f1c788c03126ca8da468833ea268e6d6de00f5ab44ec9efbfef771f7
+size 1650968

emergence_matrix_document.json

@@ -0,0 +1,356 @@
+{
+  "_meta": {
+    "version": "1.0.0",
+    "description": "6-Layer 문서작성 창발 매트릭스 — Koestler Bisociation 기반 이종 레이어 교차로 창발적 통찰 유도",
+    "philosophy": "이종 레이어 간 거리가 멀수록 높은 창발성 보너스. 에이전트가 자기 레이어 외 원격 레이어의 사고 패턴을 교차 적용할 때 독창적 문서가 탄생한다.",
+    "system": "SOMA Pre-AGI Document Emergence Engine",
+    "author": "Ginigen AI (지니젠AI)"
+  },
+  "layers": {
+    "RESEARCH": {
+      "desc": "탐색·수집 — 외부 세계의 정보를 탐지하고 정제하는 인지의 입구",
+      "agent": "水",
+      "layer_index": 0,
+      "strategies": {
+        "탐색_패턴": [
+          "수렴적 검색: 핵심 키워드를 좁혀가며 정밀 탐색",
+          "발산적 검색: 연관 키워드를 확장하며 의외의 연결고리 발견",
+          "시계열 추적: 동일 주제의 과거→현재→미래 변화 흐름 조사",
+          "반증 검색: 주장을 반박하는 자료를 의도적으로 탐색",
+          "교차 도메인 탐색: 전혀 다른 분야에서 유사 패턴 발견",
+          "원전 소급: 2차 자료에서 1차 원전(법령, 논문, 통계)으로 거슬러 올라감",
+          "이해관계자 매핑: 주제에 영향 받는 모든 주체별 관점 수집",
+          "메타 검색: '이 주제에 대한 기존 보고서/연구'를 검색하여 선행 프레임 파악"
+        ],
+        "정보_품질_필터": [
+          "출처 위계: 공식 법령 > 정부 보고서 > 학술 논문 > 언론 > 블로그",
+          "시점 검증: 최신 데이터인지, 폐기된 정보인지 연도 확인",
+          "교차 검증: 동일 팩트를 3개 이상 독립 출처에서 확인",
+          "통계 맥락화: 절대값뿐 아니라 비율, 추세, 비교 대상까지 수집",
+          "인용 체인: 누가 누구를 인용하는지 추적하여 원천 신뢰도 평가"
+        ],
+        "발견_프레임": [
+          "빈칸 탐지: 기존 자료에서 다루지 않는 영역(gap) 식별",
+          "이상값 포착: 예상과 다른 수치/사례를 발견하면 원인 추적",
+          "패턴 인식: 서로 다른 자료에서 반복되는 공통 패턴 추출",
+          "암묵지 발굴: 공식 문서에는 없지만 현장 인터뷰/사례에서 드러나는 실질 정보"
+        ]
+      }
+    },
+    "STRUCTURE": {
+      "desc": "설계·조직 — 정보를 체계적 골격으로 변환하는 건축 행위",
+      "agent": "木",
+      "layer_index": 1,
+      "strategies": {
+        "구조_아키타입": [
+          "두괄식(역피라미드): 결론 → 근거 → 배경. 의사결정자 대상 보고서",
+          "미괄식(서사형): 배경 → 분석 → 결론. 설득·제안 문서",
+          "병렬형: 동등한 주제를 나란히 배치. 비교·대안 분석",
+          "계층형(드릴다운): 거시 → 미시. 정책 → 세부 실행계획",
+          "문제-해결형: 현황(문제) → 원인 분석 → 해결 방안 → 기대효과",
+          "시계열형: 과거 → 현재 → 미래. 로드맵·추진 일정",
+          "MECE 분해: 상호배제·전체포괄. 빠짐없는 분류 체계"
+        ],
+        "섹션_설계_원리": [
+          "1섹션 1메시지: 각 섹션이 전달하는 핵심 메시지 1개를 먼저 정의",
+          "전환 브릿지: 섹션 간 논리적 연결문으로 자연스러운 흐름 보장",
+          "깊이 균형: 중요 섹션은 깊게, 부수 섹션은 간결하게",
+          "표·그림 배치: 복잡한 데이터는 표로, 흐름은 도식으로 시각화",
+          "반복 삼각: 핵심 메시지를 서론·본론·결론에서 세 번 반복"
+        ],
+        "창발적_구조": [
+          "역설 구조: 통념과 반대되는 결론을 먼저 제시하고 논증 전개",
+          "렌즈 전환: 동일 주제를 경제/기술/사회/법률 렌즈로 순환 분석",
+          "케이스 대비: 이론 섹션마다 실제 사례를 쌍으로 배치",
+          "미래 역산: 목표 상태를 먼저 정의하고 현재로 역산하여 단계 설계"
+        ]
+      }
+    },
+    "ARGUMENT": {
+      "desc": "논증·검증 — 주장을 단련하고 오류를 소각하는 비판적 사고 엔진",
+      "agent": "火",
+      "layer_index": 2,
+      "strategies": {
+        "논증_패턴": [
+          "연역법: 일반 원칙 → 구체 결론. 법령·정책 근거 활용",
+          "귀납법: 사례 축적 → 일반화. 데이터·통계 기반",
+          "유추법: A 분야 성공사례 → B 분야 적용 가능성 논증",
+          "소거법: 가능한 대안을 하나씩 배제하여 최적안 도출",
+          "비용편익: 정량적 비교로 실행 타당성 논증",
+          "반사실 논증: '만약 이 정책이 없었다면' 가상 시나리오로 필요성 입증"
+        ],
+        "팩트체크_프로토콜": [
+          "수치 검증: 출처의 원본 데이터와 대조",
+          "논리 검증: 전제 → 결론 사이 비약이 없는지 점검",
+          "시점 검증: 데이터의 기준 시점이 문서 맥락에 적합한지 확인",
+          "범위 검증: 일부 사례를 전체로 일반화하는 오류 탐지",
+          "이해충돌 검증: 출처 기관의 이해관계가 데이터에 편향을 줄 가능성 점검"
+        ],
+        "비판적_메타인지": [
+          "자기반박: 내가 작성한 논증에 대해 가장 강력한 반론을 스스로 제기",
+          "맹점 탐색: 내 분석에서 빠진 관점이 무엇인지 체계적으로 점검",
+          "확증편향 차단: 찬성 근거만 모았는지, 반대 근거도 균형 있게 수집했는지 자문",
+          "불확실성 명시: 확실한 것과 추정인 것을 구분하여 표현"
+        ]
+      }
+    },
+    "EVIDENCE": {
+      "desc": "통합·실체화 — 흩어진 조각을 하나의 완성된 문서로 주조하는 용광로",
+      "agent": "土",
+      "layer_index": 3,
+      "strategies": {
+        "통합_기법": [
+          "모자이크 통합: 각 에이전트 산출물의 최선 부분을 선별·재조합",
+          "논리 직조: 섹션 간 인과관계와 논리 체인을 명시적으로 연결",
+          "톤 통일: 전체 문서의 문체·경어법·전문용어 수준을 일관되게 조율",
+          "분량 밸런싱: 섹션별 분량을 중요도에 비례하여 재조정",
+          "중복 제거: 여러 에이전트가 반복한 내용을 단일화",
+          "표·데이터 삽입: 논증을 뒷받침하는 정량 데이터를 표 형식으로 정리"
+        ],
+        "완성도_체크": [
+          "LATCH 구조 검증: Location·Alphabet·Time·Category·Hierarchy 중 적절한 분류 사용 여부",
+          "So-What 테스트: 각 문단의 마지막에 '그래서 어떻다는 것인가?'에 답이 있는지",
+          "Elevator Test: 문서 전체를 30초 요약으로 축약 가능한지",
+          "실행 가능성: 제안된 방안이 구체적 실행 단계를 포함하는지"
+        ],
+        "독자_최적화": [
+          "독자 프로파일링: 의사결정권자/실무자/전문가 등 1차 독자 명확화",
+          "전문용어 게이트: 독자 수준에 맞는 용어 선택, 필요시 괄호 설명 추가",
+          "행동 유도: 문서를 읽은 후 독자가 취해야 할 구체적 행동 명시"
+        ]
+      }
+    },
+    "NARRATIVE": {
+      "desc": "서사·맥락 — 팩트를 이야기로 변환하여 기억과 설득력을 증폭하는 레이어",
+      "agent": null,
+      "layer_index": 4,
+      "strategies": {
+        "서사_기법": [
+          "프레이밍: 동일 사실을 '위기' 또는 '기회'로 틀 짓기에 따라 설득력 변화",
+          "구체화: 추상적 통계를 개인·기업·지역의 구체적 스토리로 변환",
+          "대비 효과: 변경 전/후, 국내/해외, 현재/미래를 나란히 보여주는 극적 대비",
+          "진행형 서사: '현재 진행 중인 변화'를 강조하여 시급성 부여",
+          "영웅의 여정: 문제 발견 → 시도와 실패 → 해결책 발견 → 성과 구조"
+        ],
+        "수사_장치": [
+          "질문 삽입: '과연 이 정책은 효과가 있을까?' 같은 독자 참여형 질문",
+          "숫자의 힘: '연간 2.3조원'보다 '국민 1인당 월 3,800원' 같은 체감 환산",
+          "유추: 복잡한 시스템을 일상적 비유로 설명",
+          "점진적 공개: 결론을 즉시 노출하지 않고 단서를 쌓아가며 논리적 긴장감 조성"
+        ],
+        "맥락_설정": [
+          "역사적 맥락: 이 정책/기술이 필요하게 된 역사적 배경",
+          "글로벌 맥락: 해외 주요국의 동향과 한국의 위치",
+          "기술적 맥락: 기반 기술의 성숙도와 실현 가능성",
+          "제도적 맥락: 관련 법령·규정·거버넌스 체계"
+        ]
+      }
+    },
+    "IMPACT": {
+      "desc": "영향·가치 — 문서가 현실에 미치는 파급력과 의사결정 촉진력을 극대화",
+      "agent": "金",
+      "layer_index": 5,
+      "strategies": {
+        "영향력_증폭": [
+          "정량 기대효과: 비용 절감, 매출 증대, 효율 향상 등 수치로 표현",
+          "정성 기대효과: 국민 편익, 산업 경쟁력, 사회적 가치 등 질적 효과",
+          "리스크 완화: 미시행 시 발생할 부정적 영향을 대비 제시",
+          "단계별 마일스톤: 단기(3개월)/중기(1년)/장기(3년) 성과 로드맵",
+          "파급 효과 체인: 1차 효과 → 2차 파생 효과 → 산업 생태계 변화"
+        ],
+        "최종_정제": [
+          "문체 일관성: 전체 문서의 어조·경어법·번호 체계 통일",
+          "용어 정밀도: 동의어 반복 제거, 약어 첫 등장시 풀네임 병기",
+          "논리 완결성: 서론의 문제제기가 결론에서 해결되는지 확인",
+          "형식 점검: 제목·번호·표·참고문헌 등 서식 규칙 준수",
+          "가독성 최적화: 문장 길이, 단락 크기, 여백 균형"
+        ],
+        "메타인지_자기검증": [
+          "오류 복구: 이전 단계 에이전트의 실수를 감지하고 자체 수정",
+          "자기 반성: 내 정제가 과도하지 않은지, 원래 의도를 훼손하지 않았는지 점검",
+          "확신도 태깅: 각 주장에 대한 확신도(높음/중간/낮음)를 내부적으로 평가",
+          "개선 루프: 수정한 부분이 새로운 문제를 야기하지 않는지 재검토"
+        ]
+      }
+    }
+  },
+  "cross_layer_bonus": {
+    "_desc": "레이어 간 거리가 멀수록 교차 적용 시 창발성이 높다. 값 = 창발성 보너스 가중치.",
+    "RESEARCH↔IMPACT": {
+      "bonus": 0.15,
+      "hint": "데이터에서 바로 시사점을 도출하면 가장 독창적 통찰이 탄생한다. 수집 단계에서 이미 '이 데이터가 의사결정에 어떤 영향을 줄까?'를 자문하라."
+    },
+    "RESEARCH↔NARRATIVE": {
+      "bonus": 0.12,
+      "hint": "건조한 데이터를 수집하면서 동시에 '이것이 어떤 이야기가 될 수 있을까?'를 상상하라."
+    },
+    "STRUCTURE↔IMPACT": {
+      "bonus": 0.11,
+      "hint": "구조 설계 단계에서 이미 '각 섹션이 최종 의사결정에 어떻게 기여하는가?'를 고려하라."
+    },
+    "STRUCTURE↔EVIDENCE": {
+      "bonus": 0.10,
+      "hint": "골격과 살을 동시에 고려하라. 구조가 근거를 자연스럽게 배치할 수 있는 형태인지 검증."
+    },
+    "ARGUMENT↔NARRATIVE": {
+      "bonus": 0.09,
+      "hint": "논증과 서사를 교차하라. 차가운 논리에 따뜻한 이야기를 입히면 설득력이 배가된다."
+    },
+    "RESEARCH↔ARGUMENT": {
+      "bonus": 0.06,
+      "hint": "수집과 검증을 동시에 수행하라. 자료를 모으면서 신뢰성을 실시간 평가."
+    },
+    "EVIDENCE↔IMPACT": {
+      "bonus": 0.05,
+      "hint": "통합 작성 시 최종 임팩트를 염두에 두면 불필요한 내용이 자연히 걸러진다."
+    }
+  },
+  "writing_principles": [
+    {
+      "id": 1,
+      "name": "모듈화(분할)",
+      "hint": "복잡한 주제를 독립적 하위 모듈로 분리하여 각각을 정밀하게 다루되, 최종 통합 시 시너지를 노려라.",
+      "application": "대주제를 3~5개 독립 섹션으로 분해. 각 섹션이 단독으로도 의미를 갖되 전체 조합 시 더 큰 그림을 형성."
+    },
+    {
+      "id": 2,
+      "name": "반론 선제(역발상)",
+      "hint": "독자가 제기할 반론을 예측하여 먼저 제시하고 논파하라. '그럼에도 불구하고' 구조.",
+      "application": "각 제안의 예상 비판(비용, 부작용, 실현가능성)을 미리 명시하고 대응 논리를 배치."
+    },
+    {
+      "id": 3,
+      "name": "관점 전환(차원변경)",
+      "hint": "동일 주제를 미시↔거시, 단기↔장기, 국내↔글로벌, 공급↔수요 등 다른 차원에서 바라보라.",
+      "application": "하나의 정책을 정부/기업/국민/국제사회 4개 관점에서 각각 분석하여 입체적 보고서 작성."
+    },
+    {
+      "id": 4,
+      "name": "융합 제안(통합)",
+      "hint": "서로 관련 없어 보이는 분야를 연결하여 독창적 해법을 제시하라.",
+      "application": "A 분야의 해결법을 B 분야에 이식. 예: 핀테크 규제 경험을 헬스테크 규제에 적용."
+    },
+    {
+      "id": 5,
+      "name": "위기→기회(전화위복)",
+      "hint": "문제점·리스크를 분석할 때, 그 자체를 차별화 기회로 전환할 수 없는지 탐색하라.",
+      "application": "규제 장벽 → '규제 준수 선점을 통한 경쟁 우위 확보' 같은 역전 논리."
+    },
+    {
+      "id": 6,
+      "name": "자기 참조(메타인지)",
+      "hint": "문서 자체가 자신의 한계와 전제를 투명하게 밝히면 신뢰도가 올라간다.",
+      "application": "분석의 한계, 데이터 제약, 추정 범위를 명시하여 독자가 판단할 근거 제공."
+    },
+    {
+      "id": 7,
+      "name": "계단식 공개(점진적 복잡성)",
+      "hint": "간단한 개념에서 시작하여 점진적으로 복잡한 내용으로 진행하라.",
+      "application": "개요(1문단) → 핵심(2문단) → 세부(5문단) → 기술적 상세(부록) 구조."
+    },
+    {
+      "id": 8,
+      "name": "공백의 힘(추출)",
+      "hint": "불필요한 내용을 과감히 제거하라. 빈 공간이 핵심 메시지를 돋보이게 한다.",
+      "application": "각 섹션에서 '없어도 되는 문장'을 최소 20% 제거. 핵심만 남겨 밀도 향상."
+    }
+  ],
+  "policy_dilemmas": [
+    {
+      "dilemma": "규제 vs 혁신",
+      "resolution": "규제 샌드박스: 한시적 규제 유예로 혁신 실험 허용 후 결과 기반 규제 설계",
+      "writing_tip": "양측 논리를 균형 있게 제시한 뒤, 제3의 절충안(샌드박스/단계적 도입)을 제안"
+    },
+    {
+      "dilemma": "보안 vs 편의성",
+      "resolution": "리스크 기반 인증: 저위험 거래는 간편 인증, 고위험 거래만 강화 인증",
+      "writing_tip": "이분법을 피하고 '위험 수준별 차등 접근' 같은 그라데이션 해법을 제시"
+    },
+    {
+      "dilemma": "중앙집중 vs 분산",
+      "resolution": "하이브리드 거버넌스: 표준·감독은 중앙, 실행·혁신은 분산",
+      "writing_tip": "각 모델의 장단점을 표로 비교한 뒤 결합 모델의 시너지를 논증"
+    },
+    {
+      "dilemma": "성과 vs 형평",
+      "resolution": "차등 지원: 성과 기반 인센티브 + 기초 역량 강화 지원 병행",
+      "writing_tip": "경쟁과 포용의 균형점을 수치 시뮬레이션으로 제시"
+    },
+    {
+      "dilemma": "단기 vs 장기",
+      "resolution": "단계별 로드맵: 단기 Quick-Win으로 추진력 확보, 장기 구조개혁으로 지속성 확보",
+      "writing_tip": "로드맵 표를 활용하여 단기(~6개월)/중기(1~2년)/장기(3~5년) 마일스톤 제시"
+    },
+    {
+      "dilemma": "개방 vs 보호",
+      "resolution": "조건부 개방: 핵심 기술은 보호하되 생태계 활성화를 위해 주변 기술은 개방",
+      "writing_tip": "개방 범위와 보호 범위를 명확히 구분하는 매트릭스 제시"
+    }
+  ],
+  "perspective_transforms": [
+    {
+      "from": "미시(개별 사례)",
+      "to": "거시(시스템 전체)",
+      "hint": "개별 기업 사례에서 시작하여 산업 전체 트렌드로 확장",
+      "writing_tip": "사례 → 패턴 → 시사점 → 정책 제언 순서로 상향 전개"
+    },
+    {
+      "from": "현재(As-Is)",
+      "to": "미래(To-Be)",
+      "hint": "현재 상태를 진단한 뒤 목표 상태를 선명하게 그리고 갭을 분석",
+      "writing_tip": "As-Is/To-Be 비교표 + 갭 분석 + 이행 로드맵 3종 세트"
+    },
+    {
+      "from": "공급자 관점",
+      "to": "수요자 관점",
+      "hint": "정책 입안자/기업이 아닌 최종 사용자/국민의 시선에서 재해석",
+      "writing_tip": "사용자 여정 맵핑으로 Pain Point를 시각화하면 설득력이 배가"
+    },
+    {
+      "from": "정량(숫자)",
+      "to": "정성(의미)",
+      "hint": "통계 뒤에 숨은 인간적 의미와 사회적 맥락을 함께 서술",
+      "writing_tip": "수치 제시 직후 '이것이 의미하는 바는' 문장으로 해석 레이어 추가"
+    },
+    {
+      "from": "국내",
+      "to": "글로벌",
+      "hint": "한국 상황을 글로벌 벤치마크와 비교하여 위치 파악",
+      "writing_tip": "주요국 비교표(미국/EU/일본/한국)로 객관적 포지셔닝 제시"
+    },
+    {
+      "from": "기술",
+      "to": "제도",
+      "hint": "기술적 가능성을 제도적 실현가능성과 교차 검토",
+      "writing_tip": "기술 성숙도(TRL)와 규제 준비도를 2×2 매트릭스로 동시 평가"
+    }
+  ],
+  "metacognitive_protocols": {
+    "_desc": "에이전트 간 상호 검증(상극)을 메타인지적 자기검증으로 구현하는 프로토콜",
+    "self_reflection": {
+      "trigger": "각 에이전트 출력 완료 직전",
+      "questions": [
+        "내 분석에서 가장 약한 고리(weakest link)는 어디인가?",
+        "내가 암묵적으로 가정하고 있는 전제는 무엇인가?",
+        "반대 입장에서 보면 어떤 반론이 가능한가?",
+        "이 문서를 읽는 비전문가도 핵심을 이해할 수 있는가?"
+      ]
+    },
+    "error_recovery": {
+      "trigger": "다음 에이전트가 이전 에이전트의 출력을 받을 때",
+      "protocol": [
+        "이전 에이전트의 주장 중 근거가 불충분한 항목 식별",
+        "논리적 비약 또는 자기모순 탐지",
+        "누락된 중요 관점 추가 제안",
+        "수정 사항을 [수정] 태그로 명시하여 투명성 확보"
+      ]
+    },
+    "confidence_calibration": {
+      "levels": {
+        "HIGH": "3개 이상 독립 출처에서 교차 검증된 팩트",
+        "MEDIUM": "1~2개 출처 기반, 논리적으로 타당하나 추가 검증 권장",
+        "LOW": "추정·추론 기반, 반드시 '추정' 또는 '가능성' 표현 사용"
+      }
+    }
+  }
+}

engine.dat

@@ -0,0 +1 @@
+m1AxF0zkqkDyXnClzXCisRhmkH5CRXC2fzeOVgozqo5Ans3wCdmRUsMMT7rYKZDUa2a5GfewhcYGX4xRFhqqmFSe8PTEAGbzHKn0QzXvWjcMZgfLCRhRNH83Rg8BZsWMwJjiwMM5Yj9pmpskOZkTJM7mfrcXQeR45YJAHR2kGmu8HLzQtWBtqmm8g+j/drDlR2a4OcWHp/xl/R4Nazn67kXOcJuZHjOcF8CDdFalTal+KNpyhBhRIamcAJ1sBu/oaspwm5sCM4c6DPRiFO9wDs7aV7cFaeR45YJHGy3WKDfOUrzTlWZEi6LBmX1Xt1VRlapjxEhMXLSupChWDg5m6HHuusiZ1rAsrAzzfiHoYwsCqmD8T1d0f8qTjFAOA6y1YFJ4krEPPIcEzodOnXrxcbrDCcQhF1wRbEvCia+qqrN0mODwCWBsn26vliQgsPF+t8IHxjAYUQhl+i4ZbRHK7nPuu9WVqjWvGseMVFGPTbPJzU+wOXnked2CQDYcZtq5C9PMUMUqQvMXpCWU0yTxs3mqXchORUR+95dAPgiwZlnCn9LUxRFS9BGwLpSfWf2zeapdyE5FRH73l0A+CLBmWcKf0tTFEVL0EbAtlJ9Zjf1+KAHvERlPCWX8AAVtDtrpetu87JVhf4Oixq1IUaJMs8j2a7cuUCkB2TdAHRRh9bEL1dxQxAVy8heE8l0l6FUrztx/cobZ5LajiwSfu6pk7mvLvPuJZkOfon9QhfwkgeFHa6ob7dWXwBdC7+nU2AMlDOXAnLQ+Mr8GwZVwUZpUeKnOANcA2+R40rpBKCGwZu9Tx7vckWZag6LGqmRRpWGzzsJPthdx6sgrS8JRCRKqonGZwOwJZn6KaZ+rIxyY8dt1Fsu2F0AvOP37KCGhxyd3ixY/B0eqNKouwL54VqFts87CT7YXcSkB7PwnNWoB4j+8HH1QCqo1szrAm1Sd6HEPyexCfIzELiTZPvDTrKplJsCQ1dAHqjSvHsCFXJ0r8XGn58V8SW1Aedy+jJKhaMOnzlK8xr1meZtpnLYlK6HxvAKkbv+K1S4s9fwgPWwQ7u9TznBfCWhbu6wM9XoN73AzfijGfIfW57SpkSBQFCetr0kuPl0J9v7yE7DyXxnvXAcCOsuxNWkpA+H8ISmh9mYtDefUnLMe/vMJsDaU0ynxcbXNy7cSfS8y+jeEUBQ/qo5MUrzyhWdLsqtwcZTT6HEGyfBrnhMfdyGvpBlXOTqssWBSvNC1ZmiDosezcFGATbPOzE+xJ3UoCfn7MTmhZtGBDPrInbwSMps6wIVckyb9swChaveGz+S2rpwVUQoqqphgUgM/ZMv+T/BJMon6TfHScAG+EeG7kLSpgDxRHD6qpWSf2sjFFFv0CaT0Qxkq8X+16wbJBM/kecm+QTc5ZvSxDfP8sp5hW6NuioLoV7ZRf4TbxQDKqarHEUX5/tXfFEDAnsfgxRdq8yKo8kIF7mETAqp1zUhxdXnQi4xXNCaqpFCZ9cwJ2JtMx21Ni/UkOh6SqnboSXF0eNyXjFYNCqqkUJ/F6MUdciXeQi7mnV89C4atTsT51SkY7PomBaFh8I0M7+yckBL+8heB9GIUJD00oqpL3fib9rplTEc1BWHbuL1SvNS4ZkSLosC/XVa3ZbPJzm+3OUjkedC6RxcoqqqiYJ7w8XXk7TGid/R7Ce5hBn9mB+owH3QUZf0ePW0JzyUN59Scsx7+8gCI81Mx70IPGBqFfITVn3jzg0YNAWD0hQzx2UoJ1vzyAIjzUzHvQg9+ZLYAysHqtB77JgRtF/5YwJji8MUsQ/QSsD8lKKk6OYtmBsUxGVksGXnw02oj0uhj8rztkWZ5n26MnuhWvVV+rtYHwBgeZQhl/C4dbTPy7kHfusKlqjStAsC5VVCRSX+m/gfGMNvmuGU1SSEeqHwlwpnbycUBfvMfrD+b8kmQs3I0jnHlso20AEHl+cTEBUDAnsfgxRdq8yKo8kIF6E8Wyc1jty9R6rSpgAFQFCp8JQzr1JytO/70LpTzTCEkPBWXq371hBlaBamTHZPd5BprC9j4m7oq/vMVvPNVCehxF8/MU3xIQ1h/5bJAIAWqq4NVn8XZxB9G8xWAPyQImD0xp2ajC/TVLzj9+yghai/6JQzr1JytOzOKK8eUQFaPdb1+KLcyT0Vcf9aLQDYdqqqiYJ/S3AnHv23pSHC/0yQ7JL6qUsWeqaq5ZTSMUSEWra9JUnicnBYynAPAg0yRJOB5ktoA+yjcmPpoN4+eoWjDpc5SLlDLD3oxogTzawHoSwcCqm/lSHBcuGX8DSFqLc7paNm87rmjgnGvDDzrniTgvQJ0xXyX2+S8qZEgUBQnra9JWwweBKqiP267q/mdePF/tfLZfNjVKAPxJIzB3eRmJZxffV1Vp/My/gEy5cFYv7MCOsu2FGfk6GX9HC+h9mbvUOBwDHXk8z9gu5ToUJFkf6nqy7AmWSkB6DeEVjcCraNfWwweBKoygj7Hr1Cd72IryepTfIweVzCpgABREjqsvVBSvOevZkOTq3BxlNPvZxfJ2WJmhMfopHUnQCMRqqqYVJ7T8cUXRj9utZskObU6HKZmANo2GVkUZf0fCGs58+9YwrrEqaoyvx7AqVRRnnizyepTsCBpLzH5N0AjEGbCtA3nyJytMjKFFgI95J0mOBSzZNF8hh5PLamcDFEcCmZWrz8RUHn4uzLDa1bo9EmB0mESy7AzZSgJ8fsMOWwA/ul+97v7oWFVu6wM818Q6UQzGGYH6TgZZhFl/BU5bAXPx1eZ+eTECV7zH5Tzbz0kPTO3qkvAiqmqyCtS+vTFzwhGpZjg8AlmQI5uqK4lKJjxeI7+B9g4HmEoZfsZIW0owyUKwNCdryozihrGrGid7mEPzsJLsTFcLx/N/CcZu9YoNM5Su9yRZmyrosCCdFewUX+m98t0TkZxf+mvQDkdZvSxwJ7M0MUtXjbeQi3mnehLOs7QX3xIVVF53IJAOTCqbulA9rvckWZEtm66q+hXtlF/hNvCAMrG6rSukhBWJyZm6H3iu9atqvb0E7z1fDnoWg4CrF7wSHF1vRl5mJOhZ9eZwJ/I5cUBQz9utZskObU6HKYahWmK1S8cwfwxAKFn06gL2PlQwjlq8xuoQ6bhajMFgmYH+DUZXgB/N5GAvGbzmQzQ1ZuFMjKbHhEi9Z3vdhvO/U98SGhwed6TQCoRYcyRwJ7Y7MUCRvIXsD8iDrE6P5qqb8CEHncsrrsUViYGZulW7rvQjGdLh26opyQnkP/PTK1g+EhoSLSoggFWKyOqmGBSvNChYVKfosGQZFCReX633gf7JNUvM837KAVtENI/vBx9UHJmbqJpnIPoVqN1fqj+APoJGU4wZfUsKaGkaCu9XnArwz9O8zKEPyQNuTojvmbFcoqo6LQe/AUpbAnG6X3KvNepqvAxrHE/Iy618Xig8gDqJNUpAMH8DSFtDv7patZwnaoWNKg6cHHlnTg9C6OrfflPVWHLqbExUA4neCnATrzFtWZ8mt3Av11RpE2tDmbXtw1hKRfF+zEFbS3GWgzswJqROjStAsC5VYMkOgCTZrMR6NUpF9n9GwWhYf6RC9PNLEen/kRvtYokNqQ6HKZ8y3KK25m4ZUxANi1g9oQL/dRKCaTwMd8AP5P4aLTlQzKELoShoecxLYyTr6QbJQvh4VDCI0ryAaw/JB64PRe/GoVxhBlTOaiCDIetqqSFQlK80K1hQKqiwYplVq54s8nVWnxIflh4z7NBOB2qq5FkmfHcxB5a8giU818t6FUPAqpz9IQeRiCpjQXh79YoON1PvMW1ZnyaaYCnJDmY7K4fGoUHSH1YeM2PjFcyP62pWJ7U7AlhbadpgKcjGojxf5TaAPwBqObpaTeO2e7pGWaIEyQvWvOta+dBPfKdJjoYm6pg/EhoRLQWWOH8odo0YM0zFzkJYXKnbqiD6FayVX+m28uwBHEvOP037fRtFMPua/q7+42kgnHeQjzrnelEJs7NR3xIYml50Lfw06yqqodMnsrZxRRO9TKsPyQqgToyvq14wElgWLSuuxRRBRaqmHhSu/KdZkS2brGb6JcuPTO3q3LJSWBcfvebjFY3DqqBfVh6nbwSNKwiDDXiV7F9f5DyB/wlGVgorrYwnWoB8+5T8npaxB939Amk9EMZWL++Aq1H5EhxWHjSh4xRHwKtj3RSelrFAXrzIrA/Iz+wPQmLbMGwOXHkfv2nRw0ZZtq5C9PMm44G/vQJmfR7PelEOsnNY7cvUZj6aDdHETlmwpkM5cBQxR1Y9Ai4PyM/sD0Ji6p23IQZcgCprw1QFBKqomBSvOWjYG2/osaocJ3oUz/OzU+wOXHkf/WKQSMYYc2NC/n0LEfWsDyhDFKtyWWy/EUogijNg6G0rqEoUQUXZul74rzJsNawMqLcgFwwJIPWcQOqDue9/rSuuxRRBRZm7mLGvOqAqjK/F8evSJ3pUgPOxWKeEx92FKmUJeHvp2b1f9X5UHrejErBeEqa+D7xeI7+B9g41S4h6fsNDUM9qrdUmOP0CWFom26ogpTTKfFjvdJHfOWng8EIUuLpu6qrkFWe29wJZlyzbqe76Fe2UX+E2ynrSXltec+vQA81Z8epvBx9UNkVTY+iaUmB+UGf0Gd8y7AGcCkB7PsMPKFh8IEM9s1QxAxr8heFQ6aQJCEMhebLFemlhdcRLYxRNBaqp2VSvNC8Zn6DQJv0YjjpSAbP03d8T35xf/aX8NPd5GUmwJnbxcI5Xj9vtIokNpmN/Q9mBsk4H3E5qYEYViAWZul+4rznmWZUu2mzoiIOpPF4iMMGxTEYUQyvpSCdagHz7lPyveWAYVWXaae7lNMp8XiO/gfYONUvFvH7NhRtF8IlDO/onLMjM4oiDPRdMe9bBwKsXvBIR3B45ZZAIT1h55nAnsbIwzJX8heF9EM171o3fijGfE9DQH/ankAgNaqsvVRSu9yRZlqDaaaL6FCRZH+p6su3JkEoDuw3QCEFZuW5C9PMUMUQSvMXkfJdFO9aG8nNT37Z

index.html

@@ -0,0 +1,471 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>한지 HANJI · On-Premise HWP AI Agent</title>
+<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@300;400;500;600;700;900&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+*{margin:0;padding:0;box-sizing:border-box;}
+:root{
+  --bg:#ffffff;--bg2:#f8f9fb;--bg3:#f1f3f6;
+  --text:#1a1a2e;--text2:#475569;--muted:#94a3b8;
+  --border:#e8ecf1;--border2:#d1d5db;
+  --accent:#4f46e5;--accent2:#6366f1;--accent-light:rgba(99,102,241,.08);
+  --teal:#0d9488;--teal-light:rgba(13,148,136,.08);
+  --amber:#d97706;--red:#dc2626;--green:#16a34a;
+  --r:12px;--r-sm:8px;
+  --font:'Noto Sans KR',sans-serif;--mono:'JetBrains Mono',monospace;
+  --shadow:0 4px 16px rgba(0,0,0,.06);--shadow-lg:0 8px 32px rgba(0,0,0,.08);
+  --tr:.2s ease;
+}
+html,body{height:100%;overflow:hidden;font-family:var(--font);background:var(--bg);color:var(--text);font-size:13px;-webkit-font-smoothing:antialiased;}
+::-webkit-scrollbar{width:5px;height:5px;}
+::-webkit-scrollbar-thumb{background:var(--border2);border-radius:10px;}
+::selection{background:var(--accent-light);color:var(--accent);}
+@keyframes shimmer{0%,100%{background-position:0%}50%{background-position:100%}}
+@keyframes fadeUp{from{opacity:0;transform:translateY(8px)}to{opacity:1;transform:none}}
+@keyframes spin{to{transform:rotate(360deg)}}
+@keyframes pulse{0%,100%{opacity:1}50%{opacity:.4}}
+
+.topbar{height:46px;display:flex;align-items:center;gap:10px;padding:0 20px;background:var(--bg);border-bottom:1px solid var(--border);}
+.logo{font-weight:900;font-size:15px;color:#1e1b4b;letter-spacing:-.3px;}
+.logo em{font-style:normal;font-weight:400;font-size:11px;color:var(--text2);margin-left:2px;}
+.topbar-sep{width:1px;height:18px;background:var(--border);margin:0 2px;}
+.topbar-desc{font-size:11px;color:var(--text2);font-weight:500;}
+.topbar-url{display:inline-flex;align-items:center;gap:4px;padding:3px 12px;border-radius:20px;
+  font-family:var(--mono);font-size:9.5px;font-weight:600;letter-spacing:.3px;
+  background:linear-gradient(135deg,#4f46e5,#4338ca);color:#fff;text-decoration:none;
+  box-shadow:0 2px 8px rgba(79,70,229,.2);transition:var(--tr);}
+.topbar-url:hover{box-shadow:0 4px 14px rgba(79,70,229,.35);transform:translateY(-1px);}
+.topbar-right{margin-left:auto;display:flex;align-items:center;gap:8px;}
+.topbar-contact{display:inline-flex;align-items:center;gap:4px;padding:3px 10px;border-radius:20px;
+  font-family:var(--mono);font-size:8.5px;font-weight:600;color:var(--teal);
+  background:var(--teal-light);border:1px solid rgba(13,148,136,.12);
+  text-decoration:none;transition:var(--tr);}
+.topbar-contact:hover{background:rgba(13,148,136,.12);}
+.chip{display:inline-flex;align-items:center;gap:4px;padding:3px 10px;border-radius:20px;
+  font-family:var(--mono);font-size:8px;font-weight:600;letter-spacing:.8px;
+  background:var(--accent-light);color:var(--accent);border:1px solid rgba(99,102,241,.12);}
+.chip-teal{background:var(--teal-light);color:var(--teal);border-color:rgba(13,148,136,.12);}
+.dot-live{width:5px;height:5px;border-radius:50%;background:var(--green);animation:pulse 2s infinite;}
+
+.main{display:grid;grid-template-columns:340px 1fr;height:calc(100vh - 50px);overflow:hidden;}
+.left{border-right:1px solid var(--border);overflow-y:auto;padding:16px;background:var(--bg);}
+.section{margin-bottom:14px;animation:fadeUp .4s ease both;}
+.section:nth-child(2){animation-delay:.05s;}
+.section:nth-child(3){animation-delay:.1s;}
+.label{font-family:var(--mono);font-size:9px;font-weight:700;letter-spacing:1.5px;text-transform:uppercase;color:var(--muted);margin-bottom:6px;}
+textarea{width:100%;border:1px solid var(--border);border-radius:var(--r-sm);padding:10px 12px;font-family:var(--font);font-size:12.5px;color:var(--text);background:var(--bg);resize:none;outline:none;transition:var(--tr);line-height:1.6;}
+textarea:focus{border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-light);}
+textarea::placeholder{color:var(--muted);font-size:11.5px;}
+
+.file-drop{border:2px dashed var(--border);border-radius:var(--r);padding:18px;text-align:center;cursor:pointer;transition:var(--tr);background:var(--bg2);}
+.file-drop:hover{border-color:var(--accent);background:var(--accent-light);}
+.file-drop.has-file{border-color:var(--green);background:rgba(22,163,74,.04);}
+.file-icon{font-size:22px;margin-bottom:4px;opacity:.4;}
+.file-hint{font-size:10px;color:var(--muted);font-family:var(--mono);}
+.file-name{font-size:11px;font-weight:600;color:var(--green);margin-top:4px;display:none;}
+
+.slider-row{display:grid;grid-template-columns:1fr 1fr;gap:10px;}
+.slider-group{background:var(--bg2);border-radius:var(--r-sm);padding:8px 10px;}
+.slider-label{font-family:var(--mono);font-size:8.5px;font-weight:600;color:var(--muted);margin-bottom:4px;display:flex;justify-content:space-between;}
+.slider-val{color:var(--accent);font-weight:700;}
+input[type=range]{width:100%;height:4px;-webkit-appearance:none;background:var(--border);border-radius:4px;outline:none;}
+input[type=range]::-webkit-slider-thumb{-webkit-appearance:none;width:14px;height:14px;border-radius:50%;background:var(--accent);cursor:pointer;border:2px solid #fff;box-shadow:0 1px 4px rgba(0,0,0,.15);}
+
+.btn{display:flex;align-items:center;justify-content:center;gap:6px;padding:10px 16px;border-radius:var(--r-sm);font-family:var(--font);font-size:12px;font-weight:600;border:none;cursor:pointer;transition:var(--tr);width:100%;}
+.btn-primary{background:linear-gradient(135deg,var(--accent),#4338ca);color:#fff;box-shadow:0 4px 12px rgba(79,70,229,.25);}
+.btn-primary:hover{box-shadow:0 6px 20px rgba(79,70,229,.35);transform:translateY(-1px);}
+.btn-primary:active{transform:translateY(0);}
+.btn-primary:disabled{opacity:.5;cursor:not-allowed;transform:none;}
+.btn-secondary{background:var(--bg2);color:var(--text2);border:1px solid var(--border);}
+.btn-secondary:hover{background:var(--bg3);}
+.btn-sm{padding:6px 10px;font-size:10.5px;border-radius:6px;}
+.btn-row{display:grid;grid-template-columns:1fr auto;gap:8px;}
+.btn-row-2{display:grid;grid-template-columns:1fr 1fr;gap:8px;}
+
+.status-bar{font-family:var(--mono);font-size:10px;color:var(--muted);padding:6px 0;display:flex;align-items:center;gap:6px;}
+.dot{width:6px;height:6px;border-radius:50%;flex-shrink:0;}
+.status-idle{background:var(--muted);}
+.status-run{background:var(--accent);animation:pulse 1.5s infinite;}
+.status-done{background:var(--green);}
+.status-err{background:var(--red);}
+
+.acc{border:1px solid var(--border);border-radius:var(--r-sm);overflow:hidden;margin-bottom:8px;}
+.acc-header{display:flex;align-items:center;gap:6px;padding:8px 12px;cursor:pointer;font-family:var(--mono);font-size:9.5px;font-weight:600;color:var(--text2);background:var(--bg2);transition:var(--tr);user-select:none;}
+.acc-header:hover{background:var(--bg3);}
+.acc-arrow{font-size:8px;transition:var(--tr);color:var(--muted);}
+.acc.open .acc-arrow{transform:rotate(90deg);}
+.acc-body{display:none;padding:10px 12px;border-top:1px solid var(--border);background:var(--bg);}
+.acc.open .acc-body{display:block;}
+.acc textarea{font-size:11px;font-family:var(--mono);line-height:1.6;background:var(--bg2);border:none;}
+
+.dl-area{background:var(--bg2);border-radius:var(--r-sm);padding:10px 12px;}
+.dl-fname{font-family:var(--mono);font-size:10px;color:var(--text2);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;margin-bottom:6px;}
+.dl-status{font-family:var(--mono);font-size:9px;margin-top:4px;}
+.dl-status.ok{color:var(--green);}
+.dl-status.err{color:var(--red);}
+
+.right{background:#d8dce2;overflow:hidden;display:flex;flex-direction:column;}
+.vt{display:flex;align-items:center;gap:8px;padding:8px 16px;background:var(--bg);border-bottom:1px solid var(--border);flex-shrink:0;}
+.vt-dots{display:flex;gap:5px;}
+.vt-dots span{width:10px;height:10px;border-radius:50%;display:block;}
+.vt-fname{font-family:var(--mono);font-size:11px;font-weight:600;color:var(--text);flex:1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}
+.vt-badge{font-family:var(--mono);font-size:7.5px;font-weight:700;padding:2px 10px;border-radius:20px;letter-spacing:.5px;}
+.badge-r{background:var(--teal-light);color:var(--teal);border:1px solid rgba(13,148,136,.15);}
+.badge-e{background:var(--accent-light);color:var(--accent);border:1px solid rgba(99,102,241,.12);}
+.badge-l{background:rgba(251,191,36,.1);color:var(--amber);border:1px solid rgba(251,191,36,.2);animation:pulse 1.5s infinite;}
+
+.vb{flex:1;overflow:hidden;position:relative;}
+.vb iframe{position:absolute;top:0;left:0;width:100%!important;height:100%!important;border:none!important;display:block;}
+.ve{position:absolute;top:0;left:0;width:100%;height:100%;display:flex;align-items:center;justify-content:center;flex-direction:column;gap:14px;color:var(--muted);background:#d8dce2;}
+.ve-icon{font-size:48px;opacity:.2;}
+.ve-text{font-family:var(--mono);font-size:10px;text-align:center;line-height:1.8;}
+
+.toast{position:fixed;bottom:20px;left:50%;transform:translateX(-50%) translateY(100px);padding:10px 20px;border-radius:var(--r);font-size:11px;font-weight:600;color:#fff;z-index:9999;opacity:0;transition:.3s ease;pointer-events:none;box-shadow:var(--shadow-lg);}
+.toast.show{opacity:1;transform:translateX(-50%) translateY(0);}
+.toast.ok{background:var(--green);}.toast.err{background:var(--red);}.toast.info{background:var(--accent);}
+
+.spinner{width:14px;height:14px;border:2px solid rgba(255,255,255,.3);border-top-color:#fff;border-radius:50%;animation:spin .6s linear infinite;display:none;}
+.running .spinner{display:inline-block;}
+#fileInput{display:none;}
+
+@media(max-width:900px){
+  .main{grid-template-columns:1fr;grid-template-rows:auto 1fr;}
+  .left{max-height:40vh;border-right:none;border-bottom:1px solid var(--border);}
+}
+</style>
+</head>
+<body>
+
+<div class="topbar">
+  <span class="logo">한지<em>(HANJI)</em></span>
+  <span class="topbar-sep"></span>
+  <span class="topbar-desc">HWP AI Agent 서���스</span>
+  <a class="topbar-url" href="https://hanji.ginigen.ai" target="_blank">🔗 hanji.ginigen.ai</a>
+  <span class="topbar-right">
+    <a class="topbar-contact" href="mailto:ginigenaihp@gmail.com">📧 문의 · 온프레미스 · 제휴</a>
+  </span>
+</div>
+
+<div class="main">
+  <div class="left">
+
+    <div class="section">
+      <div class="label">📌 프롬프트</div>
+      <textarea id="prompt" rows="3" placeholder="예: 2026년 AI 보안 유망기업 육성 지원사업 공모 안내문을 작성해주세요."></textarea>
+    </div>
+
+    <div class="section">
+      <div class="label">📎 레퍼런스 문서</div>
+      <div class="file-drop" id="fileDrop" onclick="document.getElementById('fileInput').click()">
+        <div class="file-icon">📄</div>
+        <div class="file-hint">클릭 또는 드래그하여 업로드</div>
+        <div class="file-hint" style="margin-top:2px;">HWP · HWPX · PDF · DOCX · TXT</div>
+        <div class="file-name" id="fileName"></div>
+      </div>
+      <input type="file" id="fileInput" accept=".hwp,.hwpx,.hml,.pdf,.docx,.txt,.md,.csv,.json,.xml,.xlsx">
+    </div>
+
+    <div class="section">
+      <div class="slider-row">
+        <div class="slider-group">
+          <div class="slider-label"><span>🔍 검색</span><span class="slider-val" id="valSearch">20</span></div>
+          <input type="range" min="5" max="100" step="5" value="20" id="slSearch" oninput="document.getElementById('valSearch').textContent=this.value">
+        </div>
+        <div class="slider-group">
+          <div class="slider-label"><span>🌡 Temp</span><span class="slider-val" id="valTemp">0.6</span></div>
+          <input type="range" min="0.1" max="1.0" step="0.05" value="0.6" id="slTemp" oninput="document.getElementById('valTemp').textContent=this.value">
+        </div>
+      </div>
+    </div>
+
+    <div class="section">
+      <div class="btn-row">
+        <button class="btn btn-primary" id="runBtn" onclick="runPipeline()">
+          <span class="spinner" id="btnSpin"></span>
+          <span id="btnLabel">🚀 문서 생성</span>
+        </button>
+        <button class="btn btn-secondary" onclick="stopPipeline()" style="width:44px" title="중지">⛔</button>
+      </div>
+      <div class="status-bar"><span class="dot status-idle" id="statusDot"></span><span id="statusText">대기 중</span></div>
+    </div>
+
+    <div class="section">
+      <div class="dl-area">
+        <div class="label" style="margin-bottom:4px">📥 HWPX 변환</div>
+        <div class="dl-fname" id="dlFname">파일 없음</div>
+        <div class="btn-row-2">
+          <button class="btn btn-primary btn-sm" id="dlBtn" onclick="downloadHwpx()" disabled>📥 HWPX</button>
+          <button class="btn btn-secondary btn-sm" onclick="copyDoc()">📋 복사</button>
+        </div>
+        <div class="dl-status" id="dlStatus"></div>
+      </div>
+    </div>
+
+    <!-- Doc Chat — 레퍼런스 문서 기반 QnA -->
+    <div class="acc open" id="accChat">
+      <div class="acc-header" onclick="toggleAcc('accChat')"><span class="acc-arrow">▶</span> 💬 문서 QnA 챗</div>
+      <div class="acc-body">
+        <div id="chatDocStatus" style="font-family:var(--mono);font-size:9px;color:var(--muted);margin-bottom:6px;">📎 레퍼런스 문서를 업로드하면 자동 연동됩니다</div>
+        <div id="chatMessages" style="max-height:220px;overflow-y:auto;border:1px solid var(--border);border-radius:var(--r-sm);padding:8px;margin-bottom:8px;background:var(--bg2);font-size:11px;line-height:1.7;"></div>
+        <div style="display:grid;grid-template-columns:1fr auto;gap:6px;">
+          <input type="text" id="chatInput" placeholder="문서에 대해 질문하세요..." style="font-size:12px;padding:8px 10px;" onkeydown="if(event.key==='Enter')sendChat()">
+          <button class="btn btn-primary btn-sm" onclick="sendChat()" style="width:40px;">🚀</button>
+        </div>
+      </div>
+    </div>
+
+    <div class="acc" id="accDoc">
+      <div class="acc-header" onclick="toggleAcc('accDoc')"><span class="acc-arrow">▶</span> 📝 생성된 텍스트</div>
+      <div class="acc-body"><textarea id="docArea" rows="10" placeholder="문서 생성 후 표시됩니다"></textarea></div>
+    </div>
+    <div class="acc" id="accStream">
+      <div class="acc-header" onclick="toggleAcc('accStream')"><span class="acc-arrow">▶</span> ⚡ 에이전트 스트림</div>
+      <div class="acc-body"><textarea id="streamArea" rows="8" readonly placeholder="에이전트 실시간 출력"></textarea></div>
+    </div>
+    <div class="acc" id="accLog">
+      <div class="acc-header" onclick="toggleAcc('accLog')"><span class="acc-arrow">▶</span> 🧬 파이프라인 로그</div>
+      <div class="acc-body"><textarea id="logArea" rows="6" readonly placeholder="파이프라인 로그"></textarea></div>
+    </div>
+  </div>
+
+  <div class="right">
+    <div class="vt">
+      <div class="vt-dots"><span style="background:#ff5f57"></span><span style="background:#febc2e"></span><span style="background:#28c840"></span></div>
+      <span class="vt-fname" id="viewerFname">📄 sample_hanji.hwpx</span>
+      <span class="vt-badge badge-e" id="badgeEngine">Python lxml</span>
+      <span class="vt-badge badge-r" id="badgeRender">HWPX · Full Render v3</span>
+    </div>
+    <div class="vb" id="viewerBody">
+      <div class="ve"><div class="ve-icon">⏳</div><div class="ve-text">로딩 중...</div></div>
+    </div>
+  </div>
+</div>
+
+<div class="toast" id="toast"></div>
+<a id="dlLink" style="display:none"></a>
+
+<script>
+let running=false,finalDoc='',sc=0;
+function getBase(){return '';}
+
+function showToast(m,t='info'){const e=document.getElementById('toast');e.className='toast '+t;e.textContent=m;e.classList.add('show');setTimeout(()=>e.classList.remove('show'),3000);}
+function toggleAcc(id){document.getElementById(id).classList.toggle('open');}
+function setStatus(t,s='idle'){document.getElementById('statusText').textContent=t;document.getElementById('statusDot').className='dot status-'+s;}
+
+const fi=document.getElementById('fileInput'),fd=document.getElementById('fileDrop'),fn=document.getElementById('fileName');
+fi.addEventListener('change',function(){if(this.files.length)handleFile(this.files[0]);});
+fd.addEventListener('dragover',e=>{e.preventDefault();fd.style.borderColor='var(--accent)';});
+fd.addEventListener('dragleave',()=>{fd.style.borderColor='';});
+fd.addEventListener('drop',e=>{e.preventDefault();fd.style.borderColor='';if(e.dataTransfer.files.length)handleFile(e.dataTransfer.files[0]);});
+
+function handleFile(f){
+  fn.textContent='✅ '+f.name+' ('+Math.round(f.size/1024)+'KB)';fn.style.display='block';fd.classList.add('has-file');
+  // 챗용 텍스트 추출 동시 수행
+  uploadDocForChat(f);
+  // HWP/HWPX → 뷰어 미리보기
+  const ext=f.name.split('.').pop().toLowerCase();
+  if(['hwp','hwpx'].includes(ext)){
+    const r=new FileReader();
+    r.onload=function(){renderB64(r.result.split(',')[1],'.'+ext,f.name);};
+    r.readAsDataURL(f);
+  }
+}
+
+function setEmpty(icon,msg){document.getElementById('viewerBody').innerHTML='<div class="ve"><div class="ve-icon">'+icon+'</div><div class="ve-text">'+msg+'</div></div>';}
+
+async function renderPath(path,title){
+  setEmpty('⏳','렌더링 중...');
+  document.getElementById('viewerFname').textContent='📄 '+title;
+  const b=document.getElementById('badgeRender');b.className='vt-badge badge-l';b.textContent='로딩...';
+  try{
+    const r=await fetch(getBase()+'/soma/preview',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({file_path:path})});
+    if(!r.ok)throw new Error(r.status);applyHTML(await r.text());
+  }catch(e){setEmpty('❌',e.message);b.className='vt-badge badge-e';b.textContent='Error';}
+}
+
+async function renderB64(b64,ext,title){
+  setEmpty('⏳','렌더링 중...');
+  document.getElementById('viewerFname').textContent='📄 '+title;
+  const b=document.getElementById('badgeRender');b.className='vt-badge badge-l';b.textContent='로딩...';
+  try{
+    const r=await fetch(getBase()+'/soma/preview',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({b64,ext})});
+    if(!r.ok)throw new Error(r.status);applyHTML(await r.text());
+  }catch(e){setEmpty('❌',e.message);b.className='vt-badge badge-e';b.textContent='Error';}
+}
+
+function applyHTML(h){
+  const v=document.getElementById('viewerBody');
+  if(h.includes('srcdoc=')){v.innerHTML=h;}
+  else{v.innerHTML='<div style="position:absolute;top:0;left:0;width:100%;height:100%;background:#fff;padding:16px;overflow:auto;">'+h+'</div>';}
+  const b=document.getElementById('badgeRender');
+  b.className='vt-badge badge-r';b.textContent=h.includes('ohah/hwpjs')?'✨ ohah/hwpjs WASM':'HWPX · Full Render v3';
+}
+
+async function runPipeline(){
+  const p=document.getElementById('prompt').value.trim();
+  if(!p){showToast('프롬프트를 입력하세요.','err');return;}
+  running=true;finalDoc='';sc=0;
+  document.getElementById('runBtn').classList.add('running');
+  document.getElementById('btnLabel').textContent='생성 중...';
+  document.getElementById('dlBtn').disabled=true;
+  setStatus('파이프라인 실행 중...','run');
+  document.getElementById('accStream').classList.add('open');
+  try{
+    const r=await fetch(getBase()+'/soma/run',{method:'POST',headers:{'Content-Type':'application/json'},
+      body:JSON.stringify({prompt:p,max_search:+document.getElementById('slSearch').value,temperature:+document.getElementById('slTemp').value,ref_sid:chatSid||''})});
+    if(!r.ok)throw new Error(await r.text());
+    const rd=r.body.getReader();const dec=new TextDecoder();let buf='',stream='',log='';
+    while(true){
+      const{done,value}=await rd.read();if(done||!running)break;
+      buf+=dec.decode(value,{stream:true});const lines=buf.split('\n');buf=lines.pop();
+      for(const l of lines){
+        if(!l.startsWith('data: '))continue;const d=l.slice(6);
+        if(d==='[DONE]'){running=false;break;}
+        try{const c=JSON.parse(d);
+          if(c.stream){stream+=c.stream;document.getElementById('streamArea').value=stream.slice(-4000);}
+          if(c.log){document.getElementById('logArea').value=c.log;}
+          if(c.search_count!=null){sc=c.search_count;setStatus('🔍 '+sc+'회 검색...','run');}
+          if(c.final_doc){finalDoc=c.final_doc;document.getElementById('docArea').value=finalDoc;}
+          if(c.done){finalDoc=c.final_doc||finalDoc;document.getElementById('docArea').value=finalDoc;}
+        }catch{}
+      }
+    }
+    document.getElementById('runBtn').classList.remove('running');
+    document.getElementById('btnLabel').textContent='🚀 문서 생성';
+    document.getElementById('dlBtn').disabled=!finalDoc;
+    if(finalDoc){setStatus('✅ 완료 · '+sc+'회 검색','done');showToast('✅ 문서 생성 완료!','ok');document.getElementById('accDoc').classList.add('open');}
+    else setStatus('완료 (문서 없음)','idle');
+  }catch(e){setStatus('❌ '+e.message,'err');showToast('❌ '+e.message,'err');
+    document.getElementById('runBtn').classList.remove('running');document.getElementById('btnLabel').textContent='🚀 문서 생성';}
+  running=false;
+}
+function stopPipeline(){running=false;setStatus('⛔ 중지됨','idle');document.getElementById('runBtn').classList.remove('running');document.getElementById('btnLabel').textContent='🚀 문서 생성';showToast('⛔ 중지됨');}
+
+async function downloadHwpx(){
+  if(!finalDoc){showToast('문서를 먼저 생성하세요.','err');return;}
+  document.getElementById('dlStatus').className='dl-status';document.getElementById('dlStatus').textContent='변환 중...';
+  try{
+    const r=await fetch(getBase()+'/soma/hml',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({content:finalDoc})});
+    if(!r.ok)throw new Error(await r.text());const d=await r.json();
+    if(d.file_url){
+      const a=document.getElementById('dlLink');a.href=getBase()+d.file_url;a.download=d.filename||'문서.hwpx';a.click();
+      document.getElementById('dlFname').textContent=d.filename||'문서.hwpx';
+      document.getElementById('dlStatus').className='dl-status ok';document.getElementById('dlStatus').textContent='✓ 다운로드 완료';
+      showToast('✅ HWPX 다운로드','ok');
+      if(d.file_path)renderPath(d.file_path,d.filename||'문서.hwpx');
+    }else throw new Error('file_url 없음');
+  }catch(e){document.getElementById('dlStatus').className='dl-status err';document.getElementById('dlStatus').textContent='⚠ '+e.message;showToast('❌ '+e.message,'err');}
+}
+/* ── SIMPLE MD → HTML ── */
+function md2html(s){
+  return s
+    .replace(/&/g,'&amp;').replace(/</g,'&lt;')
+    .replace(/^### (.+)$/gm,'<div style="font-weight:700;font-size:12px;color:#1e40af;margin:8px 0 4px;border-left:3px solid #6366f1;padding-left:8px;">$1</div>')
+    .replace(/^## (.+)$/gm,'<div style="font-weight:800;font-size:13px;color:#1e3a5f;margin:10px 0 4px;padding-bottom:3px;border-bottom:1.5px solid #e2e8f0;">$1</div>')
+    .replace(/^# (.+)$/gm,'<div style="font-weight:900;font-size:14px;color:#0f172a;margin:12px 0 6px;">$1</div>')
+    .replace(/\*\*(.+?)\*\*/g,'<b>$1</b>')
+    .replace(/\*(.+?)\*/g,'<i>$1</i>')
+    .replace(/`([^`]+)`/g,'<code style="background:#f1f5f9;padding:1px 5px;border-radius:3px;font-size:10px;color:#6366f1;">$1</code>')
+    .replace(/^- (.+)$/gm,'<div style="padding-left:14px;text-indent:-10px;margin:2px 0;">• $1</div>')
+    .replace(/^\d+\. (.+)$/gm,function(m,p1){return '<div style="padding-left:14px;margin:2px 0;">'+m.match(/^\d+/)[0]+'. '+p1+'</div>';})
+    .replace(/\n{2,}/g,'<div style="margin:6px 0;"></div>')
+    .replace(/\n/g,'<br>');
+}
+
+function copyDoc(){const t=document.getElementById('docArea').value;if(!t){showToast('텍스트 없음','err');return;}navigator.clipboard.writeText(t).then(()=>showToast('📋 복사됨','ok'));}
+
+/* ── DOC CHAT ── */
+let chatSid='',chatHistory=[];
+
+function addChatMsg(role,text){
+  const box=document.getElementById('chatMessages');
+  const color=role==='user'?'var(--accent)':role==='system'?'var(--muted)':'var(--teal)';
+  const label=role==='user'?'👤':role==='system'?'ℹ️':'🤖';
+  const rendered=role==='user'?text.replace(/\n/g,'<br>'):md2html(text);
+  box.innerHTML+='<div style="margin-bottom:6px;"><span style="font-weight:700;color:'+color+';font-size:10px;">'+label+'</span> <span>'+rendered+'</span></div>';
+  box.scrollTop=box.scrollHeight;
+}
+
+async function uploadDocForChat(file){
+  /* 레퍼런스 업로드 시 자동 호출 — 챗용 텍스트 추출 */
+  try{
+    const b64=await new Promise(function(res,rej){const r=new FileReader();r.onload=function(){res(r.result.split(',')[1]);};r.onerror=rej;r.readAsDataURL(file);});
+    const ext='.'+file.name.split('.').pop().toLowerCase();
+    const resp=await fetch(getBase()+'/soma/doc-upload',{method:'POST',
+      headers:{'Content-Type':'application/json'},body:JSON.stringify({b64:b64,filename:file.name,ext:ext})});
+    const d=await resp.json();
+    if(d.ok){
+      chatSid=d.sid;chatHistory=[];
+      document.getElementById('chatDocStatus').innerHTML='✅ <b>'+file.name+'</b> ('+d.chars.toLocaleString()+'자) 연동됨';
+      document.getElementById('chatMessages').innerHTML='';
+      addChatMsg('system','📄 문서 로드 완료 ('+d.chars.toLocaleString()+'자). 질문하세요!');
+    }
+  }catch(e){
+    document.getElementById('chatDocStatus').textContent='❌ 문서 분석 실패: '+e.message;
+  }
+}
+
+async function sendChat(){
+  var input=document.getElementById('chatInput');
+  var msg=input.value.trim();
+  if(!msg){return;}
+  input.value='';
+  addChatMsg('user',msg);
+  chatHistory.push([msg,'']);
+
+  try{
+    var r=await fetch(getBase()+'/soma/chat',{method:'POST',
+      headers:{'Content-Type':'application/json'},
+      body:JSON.stringify({message:msg,sid:chatSid,history:chatHistory.slice(-6)})});
+    if(!r.ok){throw new Error('서버 오류 '+r.status);}
+    var rd=r.body.getReader();
+    var dec=new TextDecoder();
+    var buf='',full='';
+    var box=document.getElementById('chatMessages');
+    var assistDiv=document.createElement('div');
+    assistDiv.style.marginBottom='6px';
+    assistDiv.innerHTML='<span style="font-weight:700;color:var(--teal);font-size:10px;">🤖</span> <span id="chatStream"></span>';
+    box.appendChild(assistDiv);
+    var streamSpan=document.getElementById('chatStream');
+
+    while(true){
+      var result=await rd.read();
+      if(result.done){break;}
+      buf+=dec.decode(result.value,{stream:true});
+      var lines=buf.split('\n');
+      buf=lines.pop();
+      for(var i=0;i<lines.length;i++){
+        var l=lines[i];
+        if(l.indexOf('data: ')!==0){continue;}
+        var d=l.slice(6);
+        if(d==='[DONE]'){break;}
+        try{var c=JSON.parse(d);if(c.delta){full+=c.delta;streamSpan.innerHTML=md2html(full);}}catch(e2){}
+      }
+      box.scrollTop=box.scrollHeight;
+    }
+    // Remove temp id
+    streamSpan.removeAttribute('id');
+    chatHistory[chatHistory.length-1][1]=full;
+  }catch(e){addChatMsg('system','❌ '+e.message);}
+}
+
+window.addEventListener('DOMContentLoaded',async()=>{
+  try{const r=await fetch(getBase()+'/soma/status');const s=await r.json();document.getElementById('badgeEngine').textContent=s.engine||'Python lxml';}catch{}
+  try{
+    const r=await fetch(getBase()+'/soma/preview',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({file_path:'/app/sample_hanji.hwpx'})});
+    if(r.ok){applyHTML(await r.text());document.getElementById('viewerFname').textContent='📄 한지(HANJI) 서비스 소개';}
+    else setEmpty('📄','문서를 생성하거나 레퍼런스를 업로드하세요.');
+  }catch{setEmpty('📄','문서를 생성하거나 레퍼런스를 업로드하세요.');}
+  // 샘플 문서 챗 자동 연동
+  try{
+    var cr=await fetch(getBase()+'/soma/doc-upload',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({file_path:'/app/sample_hanji.hwpx'})});
+    var cd=await cr.json();
+    if(cd.ok){chatSid=cd.sid;document.getElementById('chatDocStatus').innerHTML='✅ <b>한지 서비스 소개</b> ('+cd.chars.toLocaleString()+'자) 연동됨';addChatMsg('system','📄 기본 문서 로드 완료. 한지(HANJI)에 대해 질문하세요!');}
+  }catch{}
+});
+</script>
+</body>
+</html>

requirements.txt

@@ -0,0 +1,11 @@
+huggingface_hub
+requests
+fastapi
+uvicorn[standard]
+gradio
+olefile
+pyhwp
+PyPDF2
+pdfplumber
+openpyxl
+lxml