hwpx-kit-cli 0.1.1__py3-none-any.whl

hwpx_kit/commands/outline.py

@@ -0,0 +1,13 @@
+"""outline 명령 — 문단·표 배치 지도 (읽기 전용).
+
+앵커 후보를 찾을 때 원시 XML을 뒤지지 말고 이걸 쓴다: 문단 인덱스,
+텍스트, 표 위치(문서 순서 table_index)가 한 번에 나온다.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def run_outline(path: str) -> dict:
+    ad = HwpxEngineAdapter.open(path)
+    return {"file": path, "paragraphs": ad.outline()}

hwpx_kit/commands/page_break.py

@@ -0,0 +1,17 @@
+"""page-break 명령 — 문단(또는 표가 든 문단) 앞 쪽나눔.
+
+hwpx 문단의 pageBreak 속성(기본 0)을 1로 — 끼워넣은 장 헤더가 페이지
+중간에 떨어지는 문제의 해결. 대상은 문단 원문 또는 표 인덱스로 지정.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def run_page_break(path: str, at_text: str | None, table: int | None, out_path: str) -> dict:
+    if (at_text is None) == (table is None):
+        raise ValueError("--at-text 또는 --table 중 정확히 하나를 지정하세요.")
+    ad = HwpxEngineAdapter.open(path)
+    applied = ad.set_page_break(at_text=at_text, table_index=table)
+    out = ad.save_copy(out_path)
+    return {"file": path, "out": out, "at_text": at_text, "table": table, "applied": applied}

hwpx_kit/commands/read.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+import os
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+from hwpx_kit.adapter.kordoc_engine import KordocAdapter, kordoc_available
+from hwpx_kit.adapter.office_readers import read_docx, read_pdf, read_xlsx
+
+# 순수 파이썬 리더 (kordoc 흡수, 2026-07-10) — Node 불필요
+_PY_READERS = {
+    ".pdf": read_pdf,
+    ".docx": read_docx,
+    ".xlsx": read_xlsx,
+}
+
+# 구형 한글 포맷 — kordoc(있으면)만 가능. 없으면 convert 안내
+_LEGACY_HWP_EXTS = {".hwp", ".hwpml"}
+
+
+def run_read(path: str, fmt: str = "md") -> dict:
+    if fmt not in ("md", "text"):
+        raise ValueError(f"지원하지 않는 형식: {fmt} (md 또는 text)")
+
+    ext = os.path.splitext(path)[1].lower()
+
+    if ext in _PY_READERS:
+        content = _PY_READERS[ext](path)
+        return {"file": os.path.abspath(path), "format": "md", "content": content}
+
+    if ext in _LEGACY_HWP_EXTS or ext == ".xls":
+        if kordoc_available():
+            content = KordocAdapter.convert_to_markdown(path)
+            return {"file": os.path.abspath(path), "format": "md", "content": content}
+        raise RuntimeError(
+            "구형 포맷은 두 가지 방법으로 읽을 수 있습니다: "
+            "① Windows+한글 환경이면 'hwpx-kit convert'로 hwpx 변환 후 read "
+            "② 한글이 없는 환경(Mac 등)이면 kordoc 설치 (Node.js 18+ 필요: npm install -g kordoc)"
+        )
+
+    ad = HwpxEngineAdapter.open(path)
+    content = ad.export_markdown() if fmt == "md" else ad.export_text()
+    return {"file": os.path.abspath(path), "format": fmt, "content": content}

hwpx_kit/commands/render.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+import os
+
+from hwpx_kit.adapter.kordoc_engine import KordocAdapter
+
+
+def run_render(path: str, out_path: str | None = None) -> dict:
+    out = out_path or os.path.splitext(path)[0] + ".svg"
+    saved = KordocAdapter.render_svg(path, out)
+    return {"file": os.path.abspath(path), "out": saved}

hwpx_kit/commands/row_height.py

@@ -0,0 +1,39 @@
+"""row-height 명령 — 기준 행 높이를 지정 행들에 복사.
+
+사용자가 한글에서 행을 추가하면 기본 높이로 붙어 표가 들쭉날쭉해지는
+케이스의 도구측 정돈. 인덱스는 analyze 출력과 동일한 0-기준.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def parse_rows_spec(spec: str) -> list[int]:
+    """'1-3' 범위 / '1,3,5' 나열 / 혼합('1-3,5') → 정렬된 행 목록."""
+    rows: set[int] = set()
+    for part in spec.split(","):
+        part = part.strip()
+        if not part:
+            continue
+        if "-" in part:
+            lo, hi = part.split("-", 1)
+            rows.update(range(int(lo), int(hi) + 1))
+        else:
+            rows.add(int(part))
+    if not rows:
+        raise ValueError(f"행 지정이 비었습니다: {spec!r}")
+    return sorted(rows)
+
+
+def run_row_height(path: str, table: int, like: int, rows: list[int], out_path: str) -> dict:
+    ad = HwpxEngineAdapter.open(path)
+    height = ad.copy_row_height(table_index=table, like=like, rows=rows)
+    out = ad.save_copy(out_path)
+    return {
+        "file": path,
+        "out": out,
+        "table_index": table,
+        "like": like,
+        "applied_rows": rows,
+        "height": height,
+    }

hwpx_kit/commands/table_clear.py

@@ -0,0 +1,22 @@
+"""table-clear 명령 — 표의 지정 행 범위 셀 내용 비우기.
+
+전면 교체 시 새 내용과 안 맞는 표를 잔존시키지 않고 비워서, 사용자가
+빈 칸을 보고 행 삭제(한글)나 추가 내용 요청을 판단하게 한다.
+행 자체는 남는다(구조 변경 아님). 인덱스는 analyze와 동일한 0-기준.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def run_table_clear(path: str, table: int, rows: list[int] | None, out_path: str) -> dict:
+    ad = HwpxEngineAdapter.open(path)
+    cleared = ad.clear_table_rows(table_index=table, rows=rows)
+    out = ad.save_copy(out_path)
+    return {
+        "file": path,
+        "out": out,
+        "table_index": table,
+        "rows": rows,
+        "cleared_cells": cleared,
+    }

hwpx_kit/commands/table_copy.py

@@ -0,0 +1,24 @@
+"""table-copy 명령 — 표 통째 복제를 지정 문단에 삽입.
+
+장(章) 헤더 박스는 1x3 표라서, 장을 임의 개수로 늘리는 요구는
+"헤더 표 복제(table-copy) → 번호·제목 기입(table-set)" 조합으로 해결.
+삽입 위치는 fill의 text: 철학대로 문단 원문으로 지정.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def run_table_copy(path: str, table: int, after_text: str | None, out_path: str,
+                   after_table: int | None = None) -> dict:
+    ad = HwpxEngineAdapter.open(path)
+    info = ad.copy_table(table_index=table, anchor_text=after_text, after_table=after_table)
+    out = ad.save_copy(out_path)
+    return {
+        "file": path,
+        "out": out,
+        "copied_from": table,
+        "anchor_text": after_text,
+        "after_table": after_table,
+        **info,
+    }

hwpx_kit/commands/table_map_cmd.py

@@ -0,0 +1,18 @@
+"""table-map 명령 — 표 셀 상태 덤프 (좌표·텍스트·병합 anchor).
+
+병합 셀 확인을 위해 원시 XML을 파싱하던 우회를 대체하는 정식 검사 명령.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def run_table_map(path: str, table: int | None = None) -> dict:
+    ad = HwpxEngineAdapter.open(path)
+    tm = ad.table_map()
+    tables = tm.get("tables", [])
+    if table is not None:
+        if not 0 <= table < len(tables):
+            raise ValueError(f"표 인덱스 범위 밖: {table} (표 {len(tables)}개)")
+        tables = [tables[table]]
+    return {"file": path, "tables": tables}

hwpx_kit/commands/table_new.py

@@ -0,0 +1,29 @@
+"""table-new 명령 — 임의 R×C 새 표를 지정 문단에 생성.
+
+table-copy(같은 크기 복제)와 달리 크기를 지정한다. --like-table로
+기존 표의 테두리 서식 참조를 빌려 입히면 템플릿과 어울리는 표가 나온다.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def run_table_new(
+    path: str, rows: int, cols: int, after_text: str | None = None,
+    like_table: int | None = None, out_path: str = "",
+    after_table: int | None = None,
+) -> dict:
+    if rows < 1 or cols < 1:
+        raise ValueError("rows/cols는 1 이상이어야 합니다.")
+    ad = HwpxEngineAdapter.open(path)
+    ad.new_table(rows=rows, cols=cols, anchor_text=after_text,
+                 like_table=like_table, after_table=after_table)
+    out = ad.save_copy(out_path)
+    return {
+        "file": path,
+        "out": out,
+        "rows": rows,
+        "cols": cols,
+        "like_table": like_table,
+        "anchor_text": after_text,
+    }

hwpx_kit/commands/table_set.py

@@ -0,0 +1,49 @@
+"""table-set 명령 — 좌표 지정 셀 쓰기 (table-clear의 짝).
+
+비운 셀에는 라벨이 없어 fill의 table: 키가 못 닿는다 — 전면 교체 후
+새 항목명을 좌표로 직접 기입. 인덱스는 analyze와 동일한 0-기준.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def load_assignments_file(path: str) -> list[tuple[int, int, str]]:
+    """--data JSON 파일({"R,C": "값"}) → assignments. 셀 대량 기입 시
+    셸 명령 길이 한계를 피하는 경로 (fill --data와 같은 철학)."""
+    import json
+
+    with open(path, encoding="utf-8") as fh:
+        raw = json.load(fh)
+    if not isinstance(raw, dict):
+        raise ValueError('--data 파일 형식은 {"R,C": "값"} 객체여야 합니다.')
+    return parse_assignments([f"{coord}={value}" for coord, value in raw.items()])
+
+
+def parse_assignments(specs: list[str]) -> list[tuple[int, int, str]]:
+    """'R,C=값' 목록 → (row, col, value). 값 안의 '='는 그대로 허용."""
+    result = []
+    for spec in specs:
+        coord, sep, value = spec.partition("=")
+        parts = coord.split(",")
+        if not sep or len(parts) != 2:
+            raise ValueError(f"형식은 'R,C=값' 이어야 합니다: {spec!r}")
+        try:
+            result.append((int(parts[0].strip()), int(parts[1].strip()), value))
+        except ValueError as exc:
+            raise ValueError(f"좌표는 정수여야 합니다: {spec!r}") from exc
+    return result
+
+
+def run_table_set(
+    path: str, table: int, assignments: list[tuple[int, int, str]], out_path: str
+) -> dict:
+    ad = HwpxEngineAdapter.open(path)
+    count = ad.set_table_cells(table_index=table, assignments=assignments)
+    out = ad.save_copy(out_path)
+    return {
+        "file": path,
+        "out": out,
+        "table_index": table,
+        "set_cells": count,
+    }

hwpx_kit/commands/validate.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+import os
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+
+def run_validate(path: str) -> dict:
+    ad = HwpxEngineAdapter.open(path)
+    report = ad.validate()
+    issues = list(report.get("issues", []))
+    return {"file": os.path.abspath(path), "valid": not issues, "issues": issues}

hwpx_kit/format.py

@@ -0,0 +1,94 @@
+"""결정론 표기 변환 — 순수함수만. 엔진(python-hwpx/kordoc) 임포트 금지.
+
+LLM이 미세하게 틀리는 계산(큰 금액 한글 읽기, 요일, 만나이)을 못박는
+정확성 보험. 스킬은 이 값들을 손으로 계산하지 말고 CLI `fmt`로 얻는다.
+"""
+from __future__ import annotations
+
+import datetime
+import re
+
+_DIGITS = "영일이삼사오육칠팔구"
+_SMALL_UNITS = ((1000, "천"), (100, "백"), (10, "십"), (1, ""))
+_BIG_UNITS = ((10**16, "경"), (10**12, "조"), (10**8, "억"), (10**4, "만"), (1, ""))
+_WEEKDAYS = "월화수목금토일"
+
+_AMOUNT_STYLES = ("gongmun", "ilgeum")
+
+
+def _group_to_korean(n: int) -> str:
+    """0~9999를 한글로. 위변조 방지 표기 — 십/백/천 앞 '일'을 생략하지 않는다
+    (시행규칙 예시 '일십일만삼천오백육십')."""
+    parts = []
+    for value, unit in _SMALL_UNITS:
+        digit, n = divmod(n, value)
+        if digit:
+            parts.append(_DIGITS[digit] + unit)
+    return "".join(parts)
+
+
+def amount_to_korean(n: int) -> str:
+    """정수 금액의 한글 읽기. 예: 113560 → 일십일만삼천오백육십."""
+    if n < 0:
+        raise ValueError("금액은 음수가 될 수 없습니다.")
+    if n == 0:
+        return "영"
+    parts = []
+    for value, unit in _BIG_UNITS:
+        group, n = divmod(n, value)
+        if group:
+            parts.append(_group_to_korean(group) + unit)
+    return "".join(parts)
+
+
+def format_amount(n: int, style: str = "gongmun") -> str:
+    """금액 표기.
+
+    - gongmun(기본): 법정 공문 형식 — 행정 효율과 협업 촉진에 관한 규정
+      시행규칙. 예: 금113,560원(금일십일만삼천오백육십원)
+    - ilgeum: 민간 관습 형식(영수증·차용증·계약서). '정(整)'은 금액 뒤에
+      숫자를 못 붙이게 하는 위변조 방지 관습.
+      예: 일금 12,340원정(일금 일만이천삼백사십원정)
+    """
+    if style not in _AMOUNT_STYLES:
+        raise ValueError(f"style은 {'/'.join(_AMOUNT_STYLES)} 중 하나여야 합니다: {style}")
+    reading = amount_to_korean(n)
+    if style == "gongmun":
+        return f"금{n:,}원(금{reading}원)"
+    return f"일금 {n:,}원정(일금 {reading}원정)"
+
+
+def _parse_date(raw: str) -> datetime.date:
+    digits = re.sub(r"\D", "", raw)
+    if len(digits) != 8:
+        raise ValueError(f"날짜는 YYYYMMDD 8자리여야 합니다: {raw}")
+    try:
+        return datetime.date(int(digits[:4]), int(digits[4:6]), int(digits[6:8]))
+    except ValueError as exc:
+        raise ValueError(f"달력에 없는 날짜입니다: {raw}") from exc
+
+
+def gongmun_date(raw: str) -> str:
+    """공문 날짜 표기. 예: 20260101 → 2026.1.1.(목).
+    월·일 앞 0 없음, 일 뒤 마침표, 요일 괄호 — 행안부 공문 관습."""
+    d = _parse_date(raw)
+    return f"{d.year}.{d.month}.{d.day}.({_WEEKDAYS[d.weekday()]})"
+
+
+def korean_age(yymmdd: str, base: str | None = None) -> str:
+    """주민번호 앞 6자리 → 'YYMMDD(만나이)'. YY는 19YY로 해석(주민번호 관습).
+    base: 기준일 YYYYMMDD (기본 오늘)."""
+    digits = re.sub(r"\D", "", yymmdd)
+    if len(digits) != 6:
+        raise ValueError(f"생년월일은 YYMMDD 6자리여야 합니다: {yymmdd}")
+    try:
+        birth = datetime.date(1900 + int(digits[:2]), int(digits[2:4]), int(digits[4:6]))
+    except ValueError as exc:
+        raise ValueError(f"달력에 없는 생년월일입니다: {yymmdd}") from exc
+    base_date = _parse_date(base) if base else datetime.date.today()
+    age = base_date.year - birth.year - (
+        (base_date.month, base_date.day) < (birth.month, birth.day)
+    )
+    if age < 0:
+        raise ValueError("기준일이 생년월일보다 앞섭니다.")
+    return f"{digits}({age})"

hwpx_kit/output.py

@@ -0,0 +1,48 @@
+"""JSON 봉투와 stdout 위생.
+
+python-hwpx는 manifest fallback 등 경고를 print()로 stdout에 쓴다.
+--json 모드에서 stdout은 JSON 봉투 한 줄만 허용되므로, 엔진 호출은
+quiet_engine()으로 감싸 노이즈를 warnings로 회수한다.
+"""
+from __future__ import annotations
+
+import io
+import json
+import sys
+from contextlib import contextmanager
+
+
+def envelope(command, ok, data=None, warnings=None, error=None):
+    env = {"ok": ok, "command": command}
+    if data is not None:
+        env["data"] = data
+    env["warnings"] = warnings or []
+    if error is not None:
+        env["error"] = error
+    return env
+
+
+@contextmanager
+def quiet_engine():
+    captured: list[str] = []
+    buf = io.StringIO()
+    orig = sys.stdout
+    sys.stdout = buf
+    try:
+        yield captured
+    finally:
+        sys.stdout = orig
+        captured.extend(line for line in buf.getvalue().splitlines() if line.strip())
+
+
+def print_result(env, as_json):
+    if as_json:
+        print(json.dumps(env, ensure_ascii=False))
+        return
+    status = "OK" if env["ok"] else "ERROR"
+    print(f"[{status}] {env['command']}")
+    for w in env["warnings"]:
+        print(f"  warning: {w}")
+    if not env["ok"]:
+        err = env.get("error") or {}
+        print(f"  {err.get('code', '?')}: {err.get('message', '')}")

hwpx_kit_cli-0.1.1.dist-info/METADATA

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: hwpx-kit-cli
+Version: 0.1.1
+Summary: 한글(HWPX) 문서 자동화 CLI — Korean HWPX document automation for AI agents: analyze, fill, read, validate, table ops
+Project-URL: Homepage, https://github.com/6aneffy/hwpx-kit
+Project-URL: Repository, https://github.com/6aneffy/hwpx-kit
+Project-URL: Issues, https://github.com/6aneffy/hwpx-kit/issues
+Author-email: 6aneffy <tkdgus990809@gmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: claude-code,document-automation,hangul,hwp,hwpx,korean
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Office Suites
+Requires-Python: >=3.10
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pypdf>=6.14.2
+Requires-Dist: python-docx>=1.2.0
+Requires-Dist: python-hwpx<3,>=2.24
+Provides-Extra: convert
+Requires-Dist: pyhwpx; (sys_platform == 'win32') and extra == 'convert'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# hwpx-kit
+
+**한글(HWPX) 문서 자동화 — Claude Code 플러그인 & CLI**
+
+*"이 양식에 채워줘" 한마디로, 서식 무손상 한글 문서가 나옵니다.*
+
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10%2B-3776AB.svg)](https://www.python.org/)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-d97757.svg)](https://claude.com/claude-code)
+[![Tests](https://img.shields.io/badge/tests-145%20passing-brightgreen.svg)](tests/)
+
+</div>
+
+---
+
+## 무엇이 되나
+
+한글(HWP/HWPX)은 한국 공공·기업 문서의 표준이지만, AI가 다룰 수 있는 도구가 사실상 없었습니다.
+hwpx-kit은 **AI 에이전트가 한글 문서를 읽고, 채우고, 고치고, 새로 만들 수 있게** 하는 도구 모음입니다.
+
+```
+👤 "이 양식에 채워줘"                    → 서식(폰트·표·조판) 무손상으로 값만 채운 사본
+👤 "이 기획서를 ○○사업용으로 바꿔줘"      → 기존 문서를 양식 삼아 내용 전면 교체
+👤 "한글로 새 기획서 만들어줘"            → 내장 템플릿으로 표지·장·표 갖춘 문서 생성
+👤 "예산 앞에 장 하나 추가하고 표 넣어줘"   → 장 헤더 복제·새 표 생성·쪽나눔까지
+👤 "금액 한글로 병기해줘"                → 금12,340원(금일만이천삼백사십원) — 계산 착오 0
+👤 "이거 워드로도 줘" / "PPT로 만들어줘"   → docx 변환 / 발표자료 재구성
+```
+
+모든 채우기는 **원본을 절대 수정하지 않고** 사본에만 씁니다. 실제 공공기관 서식
+(보도자료·신청서·계획서·회의록·공고문)으로 왕복 검증했습니다.
+
+| | hwpx-kit 없이 | hwpx-kit으로 |
+|---|---|---|
+| 양식 채우기 | 한글 열고 칸마다 복붙, 서식 깨지면 수작업 복구 | 파일 주고 한마디 — 서식 무손상 사본 |
+| 새 기획서 | 백지에서 표지·표·조판 직접 | 내장 템플릿에 내용만 — 몇 분 완주 |
+| 금액 병기 | 손으로 한글 표기 (오타 위험) | 결정론 계산 — `금12,340원(금일만이천삼백사십원)` |
+| AI에게 한글 파일 | 못 읽음 · PDF 변환 우회 | hwpx·hwp 직접 읽기/쓰기 |
+
+**이런 분들을 위해 만들었습니다**: 공공기관·학교의 서식 담당자, 사업계획서를 반복 작성하는
+창업자·연구자, 한글 문서를 AI 워크플로에 넣고 싶은 개발자.
+
+## 30초 설치
+
+Claude Code에서:
+
+```
+/plugin marketplace add 6aneffy/hwpx-kit
+/plugin install hwpx-kit@hwpx-kit-market
+```
+
+이게 전부입니다. CLI 런타임은 첫 사용 때 스킬이 알아서 설치를 진행합니다
+(PC에 Python 3.10+만 있으면 됩니다).
+
+<details>
+<summary>수동 설치</summary>
+
+```bash
+pip install git+https://github.com/6aneffy/hwpx-kit.git
+```
+
+```powershell
+# Windows 일괄 (CLI + 플러그인 등록)
+irm https://raw.githubusercontent.com/6aneffy/hwpx-kit/main/install.ps1 | iex
+```
+</details>
+
+## 스킬 (Claude Code 플러그인)
+
+| 스킬 | 트리거 | 역할 |
+|------|--------|------|
+| **hwpx-form** | "이 양식에 채워줘" | 분석→채우기→검증 코어 워크플로. 표 조작·강조·워드 출력 포함 |
+| **doc-create** | "기획서 만들어줘" (파일 없이) | 백지 생성 라우터 — 내장 템플릿(표지·장 헤더·표 골격) 기반 |
+| **format-convert** | "금액 한글로", "요일 붙여줘" | 금액 병기·날짜 요일·만나이 — 결정론 계산 (LLM 암산 금지) |
+| **gongmun-format** | "공문 형식으로" | 행안부 공문 규약 — 글머리 위계(□○-※\*), 표기, 텍스트 정리 |
+| **table-calc** | "증감 채워줘" | 보고서 표 증감(△·%p)·비율·합계 계산과 관습 표기 |
+| **office-export** | "워드로", "PPT로" | docx 변환(한글 COM) / pptx·xlsx 재구성 |
+
+스킬은 사용자에게 **필수 정보를 먼저 묻고**(선택지 UI), 초안을 확정받은 뒤 작업합니다.
+말하지 않은 값을 지어내지 않습니다.
+
+## CLI
+
+모든 명령은 `--json`으로 한 줄 JSON 봉투(`ok`/`data`/`warnings`/`error`)를 반환합니다.
+종료 코드: `0` 성공 · `1` 오류 · `2` 부분 성공.
+
+```bash
+# 읽기·분석
+hwpx-kit analyze 양식.hwpx --json            # 채울 수 있는 필드 탐지 (fill_key 반환)
+hwpx-kit read 문서 --format md               # 본문 추출 — hwpx·PDF·DOCX·XLSX 내장 지원
+hwpx-kit outline 문서.hwpx --json            # 문단·표 배치 지도 (삽입 앵커 탐색)
+hwpx-kit table-map 문서.hwpx --table 3 --json # 표 셀 좌표·병합 상태
+hwpx-kit validate 문서.hwpx --json           # 구조 검증
+
+# 채우기·편집 (원본 불변 — 항상 --out 사본)
+hwpx-kit fill 양식.hwpx --data 값.json --out 결과.hwpx
+hwpx-kit table-set 문서.hwpx --table 3 --data 셀.json --out 결과.hwpx   # 좌표 셀 쓰기
+hwpx-kit table-clear 문서.hwpx --table 3 --rows 1-20 --out 결과.hwpx    # 셀 내용 비우기
+hwpx-kit table-copy 문서.hwpx --table 1 --after-table 4 --out 결과.hwpx # 표 통째 복제 (서식·병합 유지)
+hwpx-kit table-new 문서.hwpx --rows 6 --cols 4 --like-table 3 --after-text "앵커" --out 결과.hwpx
+hwpx-kit row-height 문서.hwpx --table 3 --like 1 --rows 2-5 --out 결과.hwpx  # 행 높이 정돈
+hwpx-kit page-break 문서.hwpx --table 5 --out 결과.hwpx                 # 쪽나눔 (새 장 시작)
+
+# 변환·생성
+hwpx-kit fmt --amount 12340 --json           # 금12,340원(금일만이천삼백사십원)
+hwpx-kit fmt --date 20260101 --json          # 2026.1.1.(목)
+hwpx-kit convert 문서.hwp --json             # .hwp → .hwpx (Windows + 한글)
+hwpx-kit export 문서.hwpx --to docx --json   # 워드로 내보내기 (Windows + 한글)
+hwpx-kit generate 초안.md --out 새문서.hwpx   # Markdown → 공문서 (kordoc)
+hwpx-kit render 문서.hwpx --out p.svg        # SVG 미리보기 (kordoc)
+```
+
+## fill_key 계약
+
+`analyze`가 주는 키를 그대로 데이터 JSON의 키로 씁니다.
+
+| 키 | 대상 | 예시 |
+|----|------|------|
+| `clickhere:<이름>` | 누름틀 필드 | `"clickhere:신청자": "김철수"` |
+| `marker:<키>` | `{{키}}` 마커 | `"marker:출장기간": "7/14~7/16"` |
+| `table:<라벨>` | 라벨 오른쪽 셀 | `"table:성명": "김철수"` |
+| `table:<라벨>#N` | 같은 라벨 N번째 | `"table:담당 부서#2": "운영과"` |
+| `table:<라벨> > <방향>` | 방향 체인 | `"table:과 장 > right > right": "010-…"` |
+| `text:<원문>` | 문장 교체 (서식 보존) | `"text:○○○ 사업": "청년 AI교육 사업"` |
+| `delete:<문단원문>` | 안내문 삭제 | `"delete:(예시입니다)": ""` |
+| `bold:` / `underline:<원문>` | 굵게·밑줄 | `"bold:핵심 성과": ""` |
+
+## 요구 사항
+
+| 기능 | 필요한 것 |
+|------|-----------|
+| 분석·채우기·검증·표 조작·표기 변환·PDF/DOCX/XLSX 읽기 | **Python 3.10+ 만** (순수 파이썬) |
+| `.hwp` 변환, 워드(docx) 내보내기 | Windows + 한글(한컴오피스) |
+| 한글 없는 환경(Mac 등)의 구형 `.hwp` 읽기, MD→HWPX, SVG | [kordoc](https://github.com/chrisryugj/kordoc) (Node 18+, 선택) |
+
+## 아키텍처
+
+```
+Claude Code 스킬 6종 ──→  hwpx-kit CLI (19 명령, JSON 봉투)
+                              └─ adapter/  ← 엔진 격리 계층
+                                  ├─ python-hwpx    hwpx 분석·채우기·표 조작
+                                  ├─ pypdf·python-docx·openpyxl   타 포맷 읽기
+                                  ├─ pyhwpx(COM)    .hwp 변환·docx 내보내기
+                                  └─ kordoc         구형 .hwp·생성·렌더 (선택)
+templates/ 기본 계획서 템플릿 (표지·장 헤더·표 골격, 마커 내장)
+```
+
+설계 불변 원칙: **① 원본 절대 수정 금지 ② `--json` stdout은 봉투 한 줄만
+③ 서식은 항상 보존** (셀을 비워도 글자모양이 유지되어 재기입 시 원래 서식을 물려받음).
+
+> 🚧 같은 코어를 MCP 서버로 노출하는 버전도 제작 중입니다 (Claude Desktop 등 MCP 클라이언트용).
+
+## 검증
+
+- 자동 테스트 145개 (pytest)
+- 실서식 수렴 테스트: 보도자료·신청서·계획서·회의록·공고문 5계열,
+  실제 공공기관 문서 30여 종으로 analyze→fill→validate 왕복
+- 실사용 시나리오 테스트 3회 (백지 생성 12분 완주, 장·표 동적 추가, 보도자료 변환)
+
+## 라이선스
+
+[Apache-2.0](LICENSE) · © 2026 [6aneffy](https://github.com/6aneffy)
+
+이슈·PR 환영합니다. 특히 실제 기관 양식에서의 analyze/fill 실패 사례 제보가 가장 값집니다
+(단, **기관 내부 문서를 이슈에 첨부하지 마세요** — 재현 가능한 합성 예시로 부탁드립니다).

hwpx_kit_cli-0.1.1.dist-info/RECORD

@@ -0,0 +1,32 @@
+hwpx_kit/__init__.py,sha256=QTYqXqSTHFRkM9TEgpDFcHvwLbvqHDqvqfQ9EiXkcAM,23
+hwpx_kit/cli.py,sha256=nMcbTcXFk4fbOv5ArXttEWDeFQiE3w0DNqhMtOcXdoc,13133
+hwpx_kit/format.py,sha256=zzCoHnlm78LPF4yphM0a3s7XP3-DacZPJxUirWZl2Bc,3891
+hwpx_kit/output.py,sha256=-9AY8rTxVpg2tAur-9XUkJHGXStEdriRKBdjq3E_RN0,1374
+hwpx_kit/adapter/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hwpx_kit/adapter/base.py,sha256=ghWGUaKRhkk6vv4j-9UC2Yv0JUglwCazrNqIB9H3k28,1341
+hwpx_kit/adapter/hwpx_engine.py,sha256=8Qi_UETncryutTpMg7uIygp7czNvf2OUPMtdhVSGFdU,25131
+hwpx_kit/adapter/kordoc_engine.py,sha256=bdOMAGygIiK-H90BK9xxqFmFsRT-tNYJPV-xsxkh-mw,3008
+hwpx_kit/adapter/office_readers.py,sha256=0dfiNOoqDYMdOM-kABDwlTgChr7sofgwJMIpA2cRQCY,1568
+hwpx_kit/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hwpx_kit/commands/analyze.py,sha256=b6RgMJ1G6hPIgQikQsCmgcyQRBjNo_o4f_OFZYX9o6Q,4578
+hwpx_kit/commands/convert.py,sha256=uhatqTVywz-JEBE1zYxCH04Q-0w0vkxG30Ks0YrQdMk,2213
+hwpx_kit/commands/export.py,sha256=mRXgzkL6OwzQlJy6NMmBTyn79OhHHAn3nHEkmuqZhZ0,1895
+hwpx_kit/commands/fill.py,sha256=Hq2_252e4lgGrQ9LhuyWjqGMB2dX2xPSDx_w0nO6T3w,3944
+hwpx_kit/commands/fmt.py,sha256=ozCH7boabBBIvlil7_Zy4vPqeLS97JtnF0nytSXYjMA,1201
+hwpx_kit/commands/generate.py,sha256=M9cWEIAJRFueASvA8Ra-INLnL3lkFF8R8YGlYVJ-1zc,518
+hwpx_kit/commands/outline.py,sha256=wBak6J6pgRfK4xy1xHEObZp1P2ldpucpakDpchHrUuU,474
+hwpx_kit/commands/page_break.py,sha256=Fmz2xWH2y_Dyq_uDBHSINxdypbgw4NFTaPiCrOFu5hI,846
+hwpx_kit/commands/read.py,sha256=rs416yvot1zx6InoqOz9CzCbwDmBXVIvh12k2cgxPHQ,1686
+hwpx_kit/commands/render.py,sha256=zfdb0fvBqm0S3ETq1a5I_y3djpWc3Vc9ahYOlfbFLmc,343
+hwpx_kit/commands/row_height.py,sha256=kJefyc5c14HbmE5qe9xAFgAqoYSBb8iwSWgpim2HHOg,1334
+hwpx_kit/commands/table_clear.py,sha256=LO9Qk2hynUIBvAXKD5h5lC5QVcOFhoN7MBpVyKxzTz8,843
+hwpx_kit/commands/table_copy.py,sha256=JRNuDRAz0kMbnHuNSLvz9GsajCVOTQ6dQMKQT36V9-k,927
+hwpx_kit/commands/table_map_cmd.py,sha256=OxeZ6VOCTUMmGzmnv2glh4OinhT6lRbNlx55eWPDPNo,696
+hwpx_kit/commands/table_new.py,sha256=TsUrF-DdfFl5xl4HWM3qRTc4FUV5aSwkIZ2jF-MPXvI,1049
+hwpx_kit/commands/table_set.py,sha256=c1gu4ejDcEAV-E2k_pK8H5TOqzueKjBab2RIzBCLdEE,1942
+hwpx_kit/commands/validate.py,sha256=iCQtk-ZFYzGmHf-DIyAzFsWjSxWIw7txzw8_gpkfDBM,348
+hwpx_kit_cli-0.1.1.dist-info/METADATA,sha256=jzUbmxT_7o3rZzVaAoTJtWCV3o1DOlAT5Giuh-2mqwI,9863
+hwpx_kit_cli-0.1.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+hwpx_kit_cli-0.1.1.dist-info/entry_points.txt,sha256=wMWfvC6GkxzVbWzcWjwqusESXzbZgup5-NURWtwiPFg,47
+hwpx_kit_cli-0.1.1.dist-info/licenses/LICENSE,sha256=dF6iw8X7b4BkcR9Z6CNirWS_EHfkE4b8KlDBfYsZ2HY,11751
+hwpx_kit_cli-0.1.1.dist-info/RECORD,,

hwpx_kit_cli-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

hwpx_kit_cli-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hwpx-kit = hwpx_kit.cli:main