python-hwpx 2.8.3__tar.gz → 2.9.1__tar.gz

python_hwpx-2.9.1/LICENSE

@@ -0,0 +1,178 @@
+Copyright 2025-2026 airmang (Dr. Wily)
+
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf of
+   any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

python_hwpx-2.9.1/NOTICE

@@ -0,0 +1,14 @@
+python-hwpx
+Copyright 2025-2026 airmang
+
+This product includes software developed by airmang.
+Licensed under the Apache License, Version 2.0.
+
+────────────────────────────────────────
+DISCLAIMER — HWPX Format
+
+"HWPX" is the document format specified and trademarked by
+Hancom Inc. (한글과컴퓨터). This project is an independent,
+unofficial implementation and is not affiliated with, endorsed by,
+or sponsored by Hancom Inc.
+────────────────────────────────────────

{python_hwpx-2.8.3/src/python_hwpx.egg-info → python_hwpx-2.9.1}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 2.8.3
-Summary: Hancom HWPX 패키지를 로드하고 편집하기 위한 Python 유틸리티 모음
+Version: 2.9.1
+Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
 Author: python-hwpx Maintainers
-License-Expression: LicenseRef-python-hwpx-NonCommercial
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/airmang/python-hwpx
-Project-URL: Documentation, https://github.com/airmang/python-hwpx/tree/main/docs
+Project-URL: Documentation, https://airmang.github.io/python-hwpx/
 Project-URL: Issues, https://github.com/airmang/python-hwpx/issues
-Keywords: hwp,hwpx,hancom,opc,xml
+Keywords: hwp,hwpx,hancom,opc,xml,document-automation,validation,template
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -19,6 +19,7 @@ Classifier: Topic :: Text Processing :: Markup :: XML
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
+License-File: NOTICE
 Requires-Dist: lxml<6,>=4.9
 Provides-Extra: dev
 Requires-Dist: build>=1.0; extra == "dev"
@@ -36,74 +37,127 @@ Dynamic: license-file
 <p align="center">
   <h1 align="center">python-hwpx</h1>
   <p align="center">
-    <strong>HWPX 문서를 Python으로 읽고, 편집하고, 생성합니다.</strong>
+    <strong>한글 없이 HWPX 문서를 Python으로 읽고, 편집하고, 생성하고, 검증합니다.</strong>
   </p>
   <p align="center">
     <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/v/python-hwpx?color=blue&label=PyPI" alt="PyPI"></a>
     <a href="https://pypi.org/project/python-hwpx/"><img src="https://img.shields.io/pypi/pyversions/python-hwpx" alt="Python"></a>
-    <a href="https://github.com/airmang/python-hwpx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Custom%20Noncommercial-orange" alt="License: Custom Non-Commercial"></a>
+    <a href="https://github.com/airmang/python-hwpx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License"></a>
     <a href="https://airmang.github.io/python-hwpx/"><img src="https://img.shields.io/badge/docs-Sphinx-8CA1AF" alt="Docs"></a>
   </p>
 </p>
 
 ---
 
-`python-hwpx`는 한컴오피스의 [HWPX 포맷](https://www.hancom.com/)을 순수 Python으로 다루는 라이브러리이자 CLI 도구 모음입니다.
-한/글 설치 없이, OS에 관계없이 HWPX 문서의 구조를 파싱하고 콘텐츠를 조작할 수 있습니다.
-문서 편집 API뿐 아니라 스키마/패키지 검증, unpack/pack, 템플릿 분석 같은 XML-first 워크플로도 함께 제공합니다.
+## 🧩 HWPX Stack (3종)
 
-> **pyhwpx / pyhwp와 다른 점?**
-> | | python-hwpx | pyhwpx | pyhwp |
-> |---|---|---|---|
-> | **대상 포맷** | `.hwpx` (OWPML/OPC) | `.hwpx` | `.hwp` (v5 바이너리) |
-> | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
-> | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
-> | **방식** | 직접 XML 파싱 | COM 자동화 | OLE 파싱 |
+| 계층 | 레포 | 역할 |
+|---|---|---|
+| 📦 라이브러리 | **[`python-hwpx`](https://github.com/airmang/python-hwpx)** | 순수 파이썬 HWPX 파싱·편집·생성 코어 |
+| 🔌 MCP 서버 | [`hwpx-mcp-server`](https://github.com/airmang/hwpx-mcp-server) | MCP 클라이언트(Claude Desktop, VS Code 등)에서 HWPX 조작 |
+| 🎯 에이전트 스킬 | [`hwpx-skill`](https://github.com/airmang/hwpx-skill) | 에이전트가 HWPX를 바로 쓰게 해주는 공식 온보딩 스킬 |
 
-## 🌍 크로스 플랫폼 지원
+---
+## 왜 python-hwpx인가
 
-HWPX 파일은 **ZIP + XML** 구조이므로, 한/글 프로그램 없이 Python만으로 읽고 편집하는 워크플로를 구성할 수 있습니다.
+- 한컴오피스 설치 불필요 — 순수 파이썬으로 어디서나 동작
+- XML-first 워크플로 — 스키마 검증·unpack/pack까지 포함
+- 에이전트·자동화 친화 — MCP 서버·Skill이 같은 스택 위에서 직결
 
-| 플랫폼 | 읽기 | 쓰기 | 비고 |
-|--------|------|------|------|
-| ✅ Windows | ✅ | ✅ | 한컴오피스 |
-| ✅ macOS | ✅ | ✅ | 한컴오피스 Mac |
-| ✅ Linux | ✅ | ✅ | 한컴오피스 Linux |
-| ✅ CI/CD | ✅ | ✅ | Docker, GitHub Actions 등 |
+## 대항 라이브러리 비교
 
-## 설치
+| 항목 | python-hwpx | pyhwp(x) 류 | ole+bin 수작업 |
+|---|---|---|---|
+| HWPX Open XML 지원 | ✅ | ⚠️ 부분 | ❌ |
+| 한컴오피스 설치 불필요 | ✅ | ✅ | ✅ |
+| 편집/생성 API | ✅ | ❌ 대부분 읽기 | ❌ |
+| 스키마 검증 | ✅ | ❌ | ❌ |
+| AI 에이전트 연동 (MCP) | ✅ (hwpx-mcp-server) | ❌ | ❌ |
 
-```bash
-pip install python-hwpx
+## ⚡ 30초 안에 가치 확인
+
+### 1. 기존 문서를 열고 수정
+
+```python
+from hwpx import HwpxDocument
+
+document = HwpxDocument.open("보고서.hwpx")
+document.add_paragraph("자동화로 추가한 문단입니다.")
+document.save_to_path("보고서-수정.hwpx")
 ```
 
-> 유일한 의존성은 `lxml`입니다.
+### 2. 양식형 표를 코드로 채우기
 
-## Quick Start
+```python
+from hwpx import HwpxDocument
+
+doc = HwpxDocument.open("신청서.hwpx")
+result = doc.fill_by_path({
+    "성명 > right": "홍길동",
+    "소속 > right": "플랫폼팀",
+})
+doc.save_to_path("신청서-작성완료.hwpx")
+
+print(result["applied_count"], result["failed_count"])
+```
+
+### 3. 텍스트 추출과 구조 검증
 
 ```python
 from hwpx import HwpxDocument
 
-# 빈 문서 새로 만들기
-doc = HwpxDocument.new()
+text = HwpxDocument.open("보고서.hwpx").export_markdown()
+print(text[:500])
+```
+
+```bash
+hwpx-validate-package 보고서.hwpx
+hwpx-analyze-template 보고서.hwpx
+```
+
+처음에는 `open/new -> edit/extract -> save_to_path` 흐름만 잡으면 된다. 패키지 구조, XML 파트, 템플릿 회귀 점검은 필요할 때만 확장하면 된다.
+
+## 어디부터 읽으면 되나
 
-# 기존 문서를 수정하려면:
-# doc = HwpxDocument.open("보고서.hwpx")
+필요한 작업부터 바로 들어가면 된다.
 
-# 문단 추가
-paragraph = doc.add_paragraph("python-hwpx로 생성한 문단입니다.")
+- **첫 파일을 열고 저장하는 최소 경로** → [`docs/quickstart.md`](docs/quickstart.md)
+- **문단, 표, 메모, 섹션 편집 패턴** → [`docs/usage.md`](docs/usage.md)
+- **텍스트 추출, 구조 조회, 검증/패키지 작업** → [`docs/usage.md`](docs/usage.md)
+- **실행 가능한 예제 모음** → [`docs/examples.md`](docs/examples.md)
+- **패키지 구조와 스키마 심화** → [`docs/schema-overview.md`](docs/schema-overview.md)
+- **설치 검증과 개발 환경 확인** → [`docs/installation.md`](docs/installation.md)
 
-# 표 추가 (2×3)
-table = doc.add_table(rows=2, cols=3)
-table.set_cell_text(0, 0, "이름")
-table.set_cell_text(0, 1, "부서")
-table.set_cell_text(0, 2, "연락처")
+## examples 하이라이트
 
-# 메모 추가 (기본 템플릿의 memo shape 사용)
-doc.add_memo_with_anchor("검토 필요", paragraph=paragraph, memo_shape_id_ref="0")
+<table>
+  <tr>
+    <td valign="top">
+      <strong><a href="examples/build_release_checklist.py">build_release_checklist.py</a></strong><br>
+      메모와 스타일 편집이 포함된 릴리스 체크리스트용 HWPX를 생성한다.
+    </td>
+    <td valign="top">
+      <strong><a href="examples/extract_text.py">extract_text.py</a></strong><br>
+      본문과 중첩 객체 텍스트를 CLI로 빠르게 추출한다.
+    </td>
+    <td valign="top">
+      <strong><a href="examples/find_objects.py">find_objects.py</a></strong><br>
+      태그·속성 기준으로 OWPML XML 노드를 추적한다.
+    </td>
+  </tr>
+</table>
 
-# 저장
-doc.save_to_path("결과물.hwpx")
+
+## Quick Start
+
+새 문서를 바로 만들고 싶다면 이렇게 시작하면 된다.
+
+```python
+from hwpx import HwpxDocument
+
+document = HwpxDocument.new()
+document.add_paragraph("python-hwpx로 만든 새 문서")
+document.save_to_path("새문서.hwpx")
 ```
 
 > 💡 컨텍스트 매니저도 지원합니다:
@@ -113,6 +167,27 @@ doc.save_to_path("결과물.hwpx")
 >     doc.save_to_path("결과물.hwpx")
 > ```
 
+표, 메모, 텍스트 추출, 검증, 패키지/XML 심화는 [`docs/quickstart.md`](docs/quickstart.md)와 [`docs/usage.md`](docs/usage.md)에서 바로 이어진다.
+
+> **pyhwpx / pyhwp와 다른 점?**
+> | | python-hwpx | pyhwpx | pyhwp |
+> |---|---|---|---|
+> | **대상 포맷** | `.hwpx` (OWPML/OPC) | `.hwpx` | `.hwp` (v5 바이너리) |
+> | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
+> | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
+> | **방식** | 직접 XML 파싱 | COM 자동화 | OLE 파싱 |
+
+## 🌍 크로스 플랫폼 지원
+
+HWPX 파일은 **ZIP + XML** 구조이므로, 한/글 프로그램 없이 Python만으로 읽고 편집하는 워크플로를 구성할 수 있습니다.
+
+| 플랫폼 | 읽기 | 쓰기 | 비고 |
+|--------|------|------|------|
+| ✅ Windows | ✅ | ✅ | 한컴오피스 |
+| ✅ macOS | ✅ | ✅ | 한컴오피스 Mac |
+| ✅ Linux | ✅ | ✅ | 한컴오피스 Linux |
+| ✅ CI/CD | ✅ | ✅ | Docker, GitHub Actions 등 |
+
 ## 주요 기능 한눈에 보기
 
 | 카테고리 | 기능 | 설명 |
@@ -121,6 +196,7 @@ doc.save_to_path("결과물.hwpx")
 | 📝 **단락** | 추가/삭제/편집/서식 | 텍스트 설정, 단락 삭제(`remove_paragraph`), 스타일 참조 |
 | ✏️ **Run** | 텍스트 조각 | 추가, 교체, 볼드/이탤릭/밑줄/색상 서식 |
 | 📊 **표(Table)** | 생성/편집/병합 | N×M 표 생성, 셀 텍스트, 셀 병합/분할, 중첩 테이블 |
+| 🧭 **표 자동화** | 탐색/채우기 | 테이블 맵, 라벨 기반 셀 탐색, 경로 기반 배치 채우기 |
 | 📑 **섹션** | 추가/삭제 | `add_section(after=)`, `remove_section()`, manifest 자동 관리 |
 | 🖼️ **이미지** | 임베드/삭제 | 바이너리 데이터 관리, manifest 자동 등록 |
 | ✏️ **도형** | 선/사각형/타원 | OWPML 명세 준수 도형 삽입 |
@@ -161,6 +237,17 @@ doc.set_footer_text("1 / 10", page_type="BOTH")
 # 표 셀 병합·분할
 table.merge_cells(0, 0, 1, 1)   # (0,0)~(1,1) 병합
 table.set_cell_text(0, 0, "병합된 셀", logical=True, split_merged=True)
+
+# 양식형 표 자동 채우기
+form = doc.add_table(2, 2)
+form.cell(0, 0).text = "성명:"
+form.cell(1, 0).text = "소속"
+
+doc.find_cell_by_label("성명")    # {"matches": [...], "count": 1}
+doc.fill_by_path({
+    "성명 > right": "홍길동",
+    "소속 > right": "플랫폼팀",
+})
 ```
 
 ### 🔍 텍스트 추출 & 검색
@@ -179,6 +266,8 @@ for obj in ObjectFinder("문서.hwpx").find_all(tag="tbl"):
     print(obj.tag, obj.path)
 ```
 
+`hp:tab`과 `ctrl id="tab"`은 탭 문자(`\t`)로 보존됩니다. 따라서 `Paragraph.text`, `TextExtractor`, `export_text()`/`export_html()`/`export_markdown()` 경로에서 같은 탭 의미를 유지한 채 roundtrip 할 수 있습니다. 필요하면 `preserve_breaks=False`로 줄바꿈/탭을 공백 기반으로 평탄화할 수 있습니다.
+
 ### 🎨 스타일 기반 텍스트 치환
 
 서식(색상, 밑줄, charPrIDRef)으로 런을 필터링해 선택적으로 교체합니다.
@@ -244,37 +333,6 @@ python-hwpx
 └── hwpx.templates       # 내장 빈 문서 템플릿
 ```
 
-## CLI
-
-```bash
-# HWPX 문서 스키마 유효성 검사
-hwpx-validate 문서.hwpx
-
-# ZIP/OPC/HWPX 패키지 구조 검사
-hwpx-validate-package 문서.hwpx
-
-# HWPX 풀기 / 다시 묶기 (기본값: XML/HWPF 바이트 보존)
-hwpx-unpack 문서.hwpx ./unpacked
-hwpx-unpack 문서.hwpx ./pretty-unpacked --pretty-xml
-hwpx-pack ./unpacked ./repacked.hwpx
-
-# 레퍼런스 문서 분석과 작업 디렉터리 추출
-hwpx-analyze-template 문서.hwpx --extract-dir ./template-parts --json
-hwpx-pack ./template-parts ./template-roundtrip.hwpx
-hwpx-validate-package ./template-roundtrip.hwpx
-
-# plain / markdown 텍스트 추출
-hwpx-text-extract 문서.hwpx --format markdown --output 문서.md
-
-# 문서 구조 변화 징후 비교
-hwpx-page-guard --reference 원본.hwpx --output 결과.hwpx
-```
-
-`hwpx-page-guard`는 렌더된 실제 쪽수를 계산하지 않습니다. 대신 단락 수, 표 수, shape/control 수, 명시적 page/column break, 텍스트 길이 같은 구조 지표를 비교해 편집 전후 변화 징후를 빠르게 점검합니다.
-
-`hwpx-validate-package`는 `Contents/content.hpf` 같은 고정 경로를 전제로 두지 않고, `META-INF/container.xml`과 실제 rootfile/manifest 선언을 따라가며 패키지 구조를 확인합니다. 엔진이 열 수 있는 비표준 패키지는 가능한 경우 경고로 분리해 보여줍니다.
-
-`hwpx-analyze-template --extract-dir`는 다시 묶고 점검하기 쉬운 작업 디렉터리를 만듭니다. 재구성과 구조 검증에 필요한 파일을 함께 꺼내는 용도이며, 편집기에서의 최종 렌더링 결과까지 보장한다는 뜻은 아닙니다.
 
 ## 문서
 
@@ -285,6 +343,7 @@ hwpx-page-guard --reference 원본.hwpx --output 결과.hwpx
 | **[📚 사용 가이드](https://airmang.github.io/python-hwpx/usage.html)** | 50+ 실전 사용 패턴 |
 | **[🔧 API 레퍼런스](https://airmang.github.io/python-hwpx/api_reference.html)** | 클래스·메서드 상세 명세 |
 | **[📐 스키마 개요](https://airmang.github.io/python-hwpx/schema-overview.html)** | OWPML 스키마 구조 설명 |
+| **[🧪 스택 통합 자료](shared/hwpx/README.md)** | fixture, smoke, validation, compatibility 운영 자료 |
 
 ## 지원 포맷
 
@@ -319,11 +378,10 @@ pip install -e ".[dev]"
 pytest
 ```
 
-## License
-
-[Custom Non-Commercial License](LICENSE) © python-hwpx Maintainers
+머지된 기여자 목록은 [CONTRIBUTORS.md](CONTRIBUTORS.md)에서 확인할 수 있습니다.
 
-Commercial use requires separate permission from the copyright holders.
+## License
+Apache License 2.0. See LICENSE and NOTICE.
 
 <br>