python-hwpx 4.2.0__tar.gz → 5.0.1__tar.gz

{python_hwpx-4.2.0/src/python_hwpx.egg-info → python_hwpx-5.0.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: python-hwpx
-Version: 4.2.0
-Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리
+Version: 5.0.1
+Summary: 한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리
 Author: python-hwpx Maintainers
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/airmang/python-hwpx
@@ -22,9 +22,6 @@ License-File: LICENSE
 License-File: NOTICE
 Requires-Dist: lxml<7,>=4.9
 Provides-Extra: visual
-Requires-Dist: pymupdf>=1.24; extra == "visual"
-Requires-Dist: pillow>=10.0; extra == "visual"
-Requires-Dist: numpy>=1.26; extra == "visual"
 Provides-Extra: xlsx
 Requires-Dist: openpyxl>=3.1; extra == "xlsx"
 Provides-Extra: preview
@@ -37,9 +34,11 @@ Requires-Dist: latex2mathml>=3.77; extra == "dev"
 Provides-Extra: test
 Requires-Dist: build>=1.0; extra == "test"
 Requires-Dist: numpy>=1.26; extra == "test"
+Requires-Dist: openpyxl>=3.1; extra == "test"
 Requires-Dist: pillow>=10.0; extra == "test"
 Requires-Dist: pytest>=7.4; extra == "test"
 Requires-Dist: pytest-cov>=5.0; extra == "test"
+Requires-Dist: pyyaml<7,>=6.0; extra == "test"
 Requires-Dist: ruff>=0.12; extra == "test"
 Requires-Dist: latex2mathml>=3.77; extra == "test"
 Provides-Extra: typecheck
@@ -66,13 +65,24 @@ Dynamic: license-file
 
 기존 문서는 손댄 곳만 고치고(미수정 영역은 바이트 그대로), 새 문서는 실제
 한컴오피스가 받아들이는 형태로 만듭니다. HWPX는 ZIP+XML(OWPML/OPC) 구조라
-Windows·macOS·Linux·CI 어디서든 순수 파이썬으로 동작합니다.
+Windows·macOS·Linux·CI 어디서든 순수 파이썬으로 동작합니다. 한컴오피스도
+Windows도 필요하지 않으므로 **ChatGPT 채팅 환경에서도 HWPX 문서를 만들고
+고칠 수 있습니다** — 파이썬이 도는 곳이면 됩니다.
 
-| | 레포 | 역할 |
+| 계층 | 저장소 | 정본 책임 |
 |---|---|---|
-| 📦 | **`python-hwpx`** | 순수 파이썬 HWPX 코어 (이 레포) |
-| 🔌 | [`hwpx-mcp-server`](https://github.com/airmang/hwpx-mcp-server) | MCP 클라이언트(Claude Desktop 등)에서 HWPX 조작 |
-| 🎯 | [`hwpx-plugin`](https://github.com/airmang/hwpx-plugins) | 에이전트용 플러그인·스킬 번들 |
+| Core | [`python-hwpx`](https://github.com/airmang/python-hwpx) | HWPX package/object model·OPC/OXML·직렬화·재사용 primitive |
+| Automation | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation) | Python 자동화·워크플로·profile/policy·렌더·선택형 MCP adapter |
+| Judgment | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) | 에이전트 intent/genre 판단·ambiguity 처리·plugin/skill 가이드 |
+
+이 저장소는 위 표의 Core 정본입니다. 5.0의 모듈 소유권, 삭제 경로 재등장
+방지, 의존성 허용 범위는
+[제품 경계 문서](docs/architecture/product-boundary.md)에 고정돼 있습니다.
+
+> **Python 블록 판정:** 이 current manual의 모든 Python 블록은
+> [실행 분류 ledger](docs/python-example-ledger.json)에 exact source digest와 함께
+> 동결돼 있습니다. **독립 실행 예제** 표시가 없는 블록은 기존 입력 파일이나 앞
+> 문맥을 요구하는 조각이며, 그대로 실행할 수 있는 예제로 간주하지 않습니다.
 
 ## 시작하기
 
@@ -80,6 +90,11 @@ Windows·macOS·Linux·CI 어디서든 순수 파이썬으로 동작합니다.
 pip install python-hwpx      # Python 3.10+
 ```
 
+> **5.x 호환 extra:** `pip install "python-hwpx[visual]"`은 기존 설치 명령을
+> 깨뜨리지 않기 위해 계속 허용되지만, `visual` extra는 비어 있어 PDF·이미지
+> 렌더링 의존성을 설치하지 않습니다. 렌더·PDF 이미징 실행은
+> `python-hwpx-automation[oracle]`이 소유합니다.
+
 ```python
 from hwpx import HwpxDocument
 
@@ -88,14 +103,21 @@ doc.add_paragraph("자동화로 추가한 문단입니다.")
 doc.save_to_path("보고서-수정.hwpx")
 ```
 
+백지에서 새 문서를 만들 때는 `HwpxDocument.new()`로 시작해 같은 API로
+문단·표·머리말을 채우고 `save_to_path()`로 저장합니다.
+
+문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
+[`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)을
+함께 설치하세요. MCP SDK 없이 같은 환경에서 그대로 동작합니다.
+
 ## 무엇을 하나
 
 - **읽기·추출** — 텍스트/HTML/rich Markdown 내보내기(서식·중첩 표·각주 보존), XPath 객체 탐색
 - **편집** — 문단·표·이미지·머리글/바닥글·메모·각주, 줄간격·여백·쪽번호 등 서식
 - **양식 채우기** — 라벨·경로 기반 셀 채움, 바이트 보존 구조 편집(행·열·오토핏·shrink-to-fit)
-- **생성** — 조립형 builder, 공문 lint·결재란, 사진대지·명패·조직도, mail merge, 신구대조표
+- **생성·일괄 처리** — 문단·표·이미지·목차·상호참조 저작, 명시적 sanitizer 기반 mail merge, 텍스트 diff
 - **변경추적·목차** — redline 저작, 네이티브 목차·상호참조
-- **검증·안전** — XSD·패키지 검증 CLI, 열림 안전 게이트, 모든 쓰기에 영수증(`MutationReport`)
+- **검증·안전** — 패키지 구조 검증 CLI, 열림 안전 게이트, 모든 쓰기에 영수증(`MutationReport`) — 번들 XSD는 느슨한 구조 스키마이며 OWPML 전체 검증은 아닙니다
 
 자세한 내용: [사용 가이드](docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [안정 API 표면](docs/stable-api.md) · [예제](docs/examples.md)
 
@@ -139,6 +161,23 @@ print(report.preservation.untouched_part_payloads.to_dict())
 > 위 수치는 *생성물 수용률* 축입니다(만든 파일을 실한컴이 받는가). 문서 *파싱 recall*과는
 > 다른 축이므로 파서 프로젝트 수치와 병치 비교하지 마세요.
 
+## 어디서 쓰나
+
+| 환경 | 무엇을 하면 되나 |
+|---|---|
+| 일반 ChatGPT 대화 | `.hwpx`를 올리고 `pip install python-hwpx` 후 파이썬으로 편집해 되받기 |
+| 로컬·서버 파이썬 | `pip install python-hwpx` — 스크립트·배치·CI |
+| 파이썬 자동화 (MCP 없이) | `pip install python-hwpx-automation` — 저작·양식 채움·검증 워크플로를 그냥 파이썬으로 |
+| ChatGPT MCP 앱 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)의 MCP adapter를 커넥터로 등록 |
+| Codex 마켓플레이스 플러그인 | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) 설치 |
+| Claude Code · Hermes · OpenClaw | 같은 MCP 서버를 각 클라이언트에 등록 ([`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)) |
+
+실측: 일반 ChatGPT 대화에 `.hwpx`를 올리고 python-hwpx 설치를 요청했을 때 PyPI
+설치가 성공했고, 문서를 편집해 되받았습니다. 다만 파이썬 실행과 네트워크 허용
+범위는 플랜·설정에 따라 다르므로 모든 계정에서 보장되는 경로는 아닙니다.
+네트워크가 막힌 실행 환경에서는 wheel 파일을 함께 업로드하면 오프라인 설치로
+같은 여정이 됩니다.
+
 ## 비교
 
 | | python-hwpx | pyhwpx | pyhwp |
@@ -147,14 +186,17 @@ print(report.preservation.untouched_part_payloads.to_dict())
 | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
 | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 | **편집/생성 API** | ✅ | ✅ (COM) | ❌ 대부분 읽기 |
-| **AI 에이전트 연동 (MCP)** | ✅ | ❌ | ❌ |
+| **AI 에이전트 연동 (MCP)** | ✅ companion 경유 | ❌ | ❌ |
 
 > HWP(v5 바이너리)는 지원하지 않습니다. 한컴오피스에서 HWPX로 변환 후 사용하세요.
 
 ## 알려진 제약
 
-- `add_shape()` / `add_control()`은 한/글이 요구하는 모든 하위 요소를 생성하지 않습니다.
-- `<hp:pic>` 그림 개체의 완전 자동 생성은 제공하지 않습니다.
+- `add_shape()` / `add_control()`은 한/글이 요구하는 모든 하위 요소를 생성하지 않는
+  저수준 탈출구입니다. 그대로 저장한 문서는 한/글이 열지 못하며, 신호는 호출 시점의
+  경고 하나뿐입니다(저장도 패키지 검증도 막지 않습니다). 도형은 `add_line()` /
+  `add_rectangle()` / `add_ellipse()`를 쓰세요.
+- 그림은 단순 개체 생성까지 지원하며, 그룹·효과 같은 복잡 개체 생성은 미지원입니다.
 - 암호화된 HWPX는 지원하지 않습니다.
 
 ## 기여하기

{python_hwpx-4.2.0 → python_hwpx-5.0.1}/README.md

@@ -17,13 +17,24 @@
 
 기존 문서는 손댄 곳만 고치고(미수정 영역은 바이트 그대로), 새 문서는 실제
 한컴오피스가 받아들이는 형태로 만듭니다. HWPX는 ZIP+XML(OWPML/OPC) 구조라
-Windows·macOS·Linux·CI 어디서든 순수 파이썬으로 동작합니다.
+Windows·macOS·Linux·CI 어디서든 순수 파이썬으로 동작합니다. 한컴오피스도
+Windows도 필요하지 않으므로 **ChatGPT 채팅 환경에서도 HWPX 문서를 만들고
+고칠 수 있습니다** — 파이썬이 도는 곳이면 됩니다.
 
-| | 레포 | 역할 |
+| 계층 | 저장소 | 정본 책임 |
 |---|---|---|
-| 📦 | **`python-hwpx`** | 순수 파이썬 HWPX 코어 (이 레포) |
-| 🔌 | [`hwpx-mcp-server`](https://github.com/airmang/hwpx-mcp-server) | MCP 클라이언트(Claude Desktop 등)에서 HWPX 조작 |
-| 🎯 | [`hwpx-plugin`](https://github.com/airmang/hwpx-plugins) | 에이전트용 플러그인·스킬 번들 |
+| Core | [`python-hwpx`](https://github.com/airmang/python-hwpx) | HWPX package/object model·OPC/OXML·직렬화·재사용 primitive |
+| Automation | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation) | Python 자동화·워크플로·profile/policy·렌더·선택형 MCP adapter |
+| Judgment | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) | 에이전트 intent/genre 판단·ambiguity 처리·plugin/skill 가이드 |
+
+이 저장소는 위 표의 Core 정본입니다. 5.0의 모듈 소유권, 삭제 경로 재등장
+방지, 의존성 허용 범위는
+[제품 경계 문서](docs/architecture/product-boundary.md)에 고정돼 있습니다.
+
+> **Python 블록 판정:** 이 current manual의 모든 Python 블록은
+> [실행 분류 ledger](docs/python-example-ledger.json)에 exact source digest와 함께
+> 동결돼 있습니다. **독립 실행 예제** 표시가 없는 블록은 기존 입력 파일이나 앞
+> 문맥을 요구하는 조각이며, 그대로 실행할 수 있는 예제로 간주하지 않습니다.
 
 ## 시작하기
 
@@ -31,6 +42,11 @@ Windows·macOS·Linux·CI 어디서든 순수 파이썬으로 동작합니다.
 pip install python-hwpx      # Python 3.10+
 ```
 
+> **5.x 호환 extra:** `pip install "python-hwpx[visual]"`은 기존 설치 명령을
+> 깨뜨리지 않기 위해 계속 허용되지만, `visual` extra는 비어 있어 PDF·이미지
+> 렌더링 의존성을 설치하지 않습니다. 렌더·PDF 이미징 실행은
+> `python-hwpx-automation[oracle]`이 소유합니다.
+
 ```python
 from hwpx import HwpxDocument
 
@@ -39,14 +55,21 @@ doc.add_paragraph("자동화로 추가한 문단입니다.")
 doc.save_to_path("보고서-수정.hwpx")
 ```
 
+백지에서 새 문서를 만들 때는 `HwpxDocument.new()`로 시작해 같은 API로
+문단·표·머리말을 채우고 `save_to_path()`로 저장합니다.
+
+문서 저작·양식 채움·시험지 조판 같은 상위 워크플로가 필요하면
+[`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)을
+함께 설치하세요. MCP SDK 없이 같은 환경에서 그대로 동작합니다.
+
 ## 무엇을 하나
 
 - **읽기·추출** — 텍스트/HTML/rich Markdown 내보내기(서식·중첩 표·각주 보존), XPath 객체 탐색
 - **편집** — 문단·표·이미지·머리글/바닥글·메모·각주, 줄간격·여백·쪽번호 등 서식
 - **양식 채우기** — 라벨·경로 기반 셀 채움, 바이트 보존 구조 편집(행·열·오토핏·shrink-to-fit)
-- **생성** — 조립형 builder, 공문 lint·결재란, 사진대지·명패·조직도, mail merge, 신구대조표
+- **생성·일괄 처리** — 문단·표·이미지·목차·상호참조 저작, 명시적 sanitizer 기반 mail merge, 텍스트 diff
 - **변경추적·목차** — redline 저작, 네이티브 목차·상호참조
-- **검증·안전** — XSD·패키지 검증 CLI, 열림 안전 게이트, 모든 쓰기에 영수증(`MutationReport`)
+- **검증·안전** — 패키지 구조 검증 CLI, 열림 안전 게이트, 모든 쓰기에 영수증(`MutationReport`) — 번들 XSD는 느슨한 구조 스키마이며 OWPML 전체 검증은 아닙니다
 
 자세한 내용: [사용 가이드](docs/usage.md) · [API 레퍼런스](https://airmang.github.io/python-hwpx/) · [안정 API 표면](docs/stable-api.md) · [예제](docs/examples.md)
 
@@ -90,6 +113,23 @@ print(report.preservation.untouched_part_payloads.to_dict())
 > 위 수치는 *생성물 수용률* 축입니다(만든 파일을 실한컴이 받는가). 문서 *파싱 recall*과는
 > 다른 축이므로 파서 프로젝트 수치와 병치 비교하지 마세요.
 
+## 어디서 쓰나
+
+| 환경 | 무엇을 하면 되나 |
+|---|---|
+| 일반 ChatGPT 대화 | `.hwpx`를 올리고 `pip install python-hwpx` 후 파이썬으로 편집해 되받기 |
+| 로컬·서버 파이썬 | `pip install python-hwpx` — 스크립트·배치·CI |
+| 파이썬 자동화 (MCP 없이) | `pip install python-hwpx-automation` — 저작·양식 채움·검증 워크플로를 그냥 파이썬으로 |
+| ChatGPT MCP 앱 | [`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)의 MCP adapter를 커넥터로 등록 |
+| Codex 마켓플레이스 플러그인 | [`hwpx-plugins`](https://github.com/airmang/hwpx-plugins) 설치 |
+| Claude Code · Hermes · OpenClaw | 같은 MCP 서버를 각 클라이언트에 등록 ([`python-hwpx-automation`](https://github.com/airmang/python-hwpx-automation)) |
+
+실측: 일반 ChatGPT 대화에 `.hwpx`를 올리고 python-hwpx 설치를 요청했을 때 PyPI
+설치가 성공했고, 문서를 편집해 되받았습니다. 다만 파이썬 실행과 네트워크 허용
+범위는 플랜·설정에 따라 다르므로 모든 계정에서 보장되는 경로는 아닙니다.
+네트워크가 막힌 실행 환경에서는 wheel 파일을 함께 업로드하면 오프라인 설치로
+같은 여정이 됩니다.
+
 ## 비교
 
 | | python-hwpx | pyhwpx | pyhwp |
@@ -98,14 +138,17 @@ print(report.preservation.untouched_part_payloads.to_dict())
 | **한/글 설치** | 불필요 | 필요 (Windows COM) | 불필요 |
 | **크로스 플랫폼** | ✅ Linux / macOS / Windows / CI | ❌ Windows 전용 | ✅ |
 | **편집/생성 API** | ✅ | ✅ (COM) | ❌ 대부분 읽기 |
-| **AI 에이전트 연동 (MCP)** | ✅ | ❌ | ❌ |
+| **AI 에이전트 연동 (MCP)** | ✅ companion 경유 | ❌ | ❌ |
 
 > HWP(v5 바이너리)는 지원하지 않습니다. 한컴오피스에서 HWPX로 변환 후 사용하세요.
 
 ## 알려진 제약
 
-- `add_shape()` / `add_control()`은 한/글이 요구하는 모든 하위 요소를 생성하지 않습니다.
-- `<hp:pic>` 그림 개체의 완전 자동 생성은 제공하지 않습니다.
+- `add_shape()` / `add_control()`은 한/글이 요구하는 모든 하위 요소를 생성하지 않는
+  저수준 탈출구입니다. 그대로 저장한 문서는 한/글이 열지 못하며, 신호는 호출 시점의
+  경고 하나뿐입니다(저장도 패키지 검증도 막지 않습니다). 도형은 `add_line()` /
+  `add_rectangle()` / `add_ellipse()`를 쓰세요.
+- 그림은 단순 개체 생성까지 지원하며, 그룹·효과 같은 복잡 개체 생성은 미지원입니다.
 - 암호화된 HWPX는 지원하지 않습니다.
 
 ## 기여하기

{python_hwpx-4.2.0 → python_hwpx-5.0.1}/pyproject.toml

@@ -1,11 +1,11 @@
 [build-system]
-requires = ["setuptools>=77.0.0", "wheel"]
+requires = ["setuptools==83.0.0", "wheel==0.47.0"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx"
-version = "4.2.0"
-description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 자동화 라이브러리"
+version = "5.0.1"
+description = "한글 없이 HWPX 문서를 열고, 편집하고, 생성하고, 검증하는 Python 문서 라이브러리"
 readme = { file = "README.md", content-type = "text/markdown" }
 license = "Apache-2.0"
 license-files = ["LICENSE", "NOTICE"]
@@ -29,11 +29,10 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-visual = [
-    "pymupdf>=1.24",
-    "pillow>=10.0",
-    "numpy>=1.26",
-]
+# 5.0에서 core는 PDF도 이미지도 읽지 않는다. 렌더 백엔드와 word-box 추출은
+# 주입받는 계약이고, 그 스택은 companion 계층이 소유한다. 이름은 기존 설치가
+# `python-hwpx[visual]`로 깨지지 않도록 남기되 아무것도 끌어오지 않는다.
+visual = []
 # Excel(.xlsx/.xlsm) 명부 ingestion for mail_merge. Lazy-imported; absent => clear error.
 xlsx = [
     "openpyxl>=3.1",
@@ -52,9 +51,11 @@ dev = [
 test = [
     "build>=1.0",
     "numpy>=1.26",
+    "openpyxl>=3.1",
     "pillow>=10.0",
     "pytest>=7.4",
     "pytest-cov>=5.0",
+    "pyyaml>=6.0,<7",
     "ruff>=0.12",
     "latex2mathml>=3.77",
 ]
@@ -69,7 +70,11 @@ Documentation = "https://airmang.github.io/python-hwpx/"
 Issues = "https://github.com/airmang/python-hwpx/issues"
 
 [project.scripts]
-hwpx = "hwpx.agent.cli:main"
+# The `hwpx` application CLI moved to python-hwpx-automation, which declares the
+# name in the train that raises its core floor to 5.0 — so no valid install ever
+# has two declarers of it. `hwpx-conformance` is gone too: its package is
+# repository QA and no longer ships, and a console script pointing into an
+# excluded package would install as a command that cannot start.
 hwpx-unpack = "hwpx.tools.archive_cli:unpack_main"
 hwpx-pack = "hwpx.tools.archive_cli:pack_main"
 hwpx-validate = "hwpx.tools.validator:main"
@@ -78,33 +83,52 @@ hwpx-page-guard = "hwpx.tools.page_guard:main"
 hwpx-analyze-template = "hwpx.tools.template_analyzer:main"
 hwpx-text-extract = "hwpx.tools.text_extract_cli:main"
 hwpx-repair = "hwpx.tools.repair:main"
-hwpx-conformance = "hwpx.conformance.runner:main"
 
 [tool.setuptools]
 package-dir = { "" = "src" }
 include-package-data = true
+# Namespace-aware discovery. hwpx/opc and hwpx/data carry no __init__.py, so a
+# plain find_packages misses them, and they only ever shipped because
+# include-package-data swept them in as data files of hwpx. That same sweep kept
+# hwpx/benchmark and hwpx/conformance in the wheel after they were excluded from
+# the package list — one mechanism, helping in one place and hurting in the other.
+# The list is deliberately exact. A wildcard made any new directory below
+# ``src/hwpx`` publishable without a packaging review, which is the opposite of
+# the library/application boundary. Namespace packages (``opc`` and ``data``)
+# are valid explicit entries.
+packages = [
+    "hwpx",
+    "hwpx._document",
+    "hwpx.data",
+    "hwpx.equation",
+    "hwpx.form_fit",
+    "hwpx.ingest",
+    "hwpx.layout",
+    "hwpx.opc",
+    "hwpx.oxml",
+    "hwpx.quality",
+    "hwpx.tools",
+    "hwpx.tools._schemas",
+]
 
-[tool.setuptools.packages.find]
-where = ["src"]
-include = ["hwpx*"]
+# Only packages that ship. A key here for an excluded or deleted package pulls it
+# back into the wheel: hwpx.conformance was excluded from packages.find and still
+# shipped because this table named it, and hwpx.design no longer exists at all.
 
+# Listed explicitly rather than discovered with an exclude pattern. The exclude
+# form silently failed to keep hwpx.benchmark and hwpx.conformance out of the
+# wheel, and a packaging rule that looks right while shipping the opposite is
+# worse than a longer list. Adding a package here is a deliberate act.
 [tool.setuptools.package-data]
 "hwpx" = ["py.typed"]
 "hwpx.tools" = ["_schemas/*.xsd"]
 "hwpx.data" = ["Skeleton.hwpx"]
-"hwpx.visual" = ["_render_hwpx.ps1", "_render_hwpx_mac.applescript", "_refresh_hwpx_mac.applescript", "_hancom_open_rate.ps1"]
-"hwpx.design" = [
-    "profiles/*/profile.json",
-    "profiles/*/template.hwpx",
-    "profiles/*/fragments/*.xml",
-]
-"hwpx.conformance" = [
-    "corpus/corpus.json",
-    "corpus/*.hwpx",
-]
 
 [tool.pytest.ini_options]
-pythonpath = ["src"]
+# scripts/ carries repository QA harnesses that are not library surface — the
+# fuzz loop moved there in 5.0 because it needs the MCP owner's builder, and
+# core must never import a companion layer.
+pythonpath = ["src", "scripts"]
 addopts = "-ra"
 testpaths = ["tests"]
 
@@ -124,6 +148,8 @@ files = [
     "src/hwpx/equation/mathml.py",
     "src/hwpx/equation/render.py",
     "src/hwpx/tools/document_viewer.py",
+    "src/hwpx/tools/mail_merge.py",
+    "src/hwpx/tools/redline.py",
     "src/hwpx/_document/_units.py",
     "src/hwpx/_document/fields.py",
     "src/hwpx/_document/layout.py",
@@ -132,9 +158,6 @@ files = [
     "src/hwpx/_document/persistence.py",
     "src/hwpx/_document/shapes.py",
     "src/hwpx/_document/tracked.py",
-    "src/hwpx/agent/commands.py",
-    "src/hwpx/agent/document.py",
-    "src/hwpx/agent/story.py",
     "src/hwpx/oxml/_document_impl.py",
     "src/hwpx/oxml/_document_primitives.py",
     "src/hwpx/oxml/document.py",
@@ -153,6 +176,7 @@ files = [
     "src/hwpx/oxml/simple_parts.py",
     "src/hwpx/oxml/table.py",
     "src/hwpx/quality/policy.py",
+    "src/hwpx/quality/rendering.py",
     "src/hwpx/quality/report.py",
     "src/hwpx/tools/archive_cli.py",
     "src/hwpx/tools/package_validator.py",
@@ -160,7 +184,6 @@ files = [
     "src/hwpx/tools/template_analyzer.py",
     "src/hwpx/tools/text_extract_cli.py",
     "src/hwpx/tools/text_extractor.py",
-    "src/hwpx/visual/oracle.py",
     "tests/template_automation/helpers.py",
     "tests/template_automation/generate_fixtures.py",
 ]
@@ -179,6 +202,8 @@ include = [
     "src/hwpx/equation/mathml.py",
     "src/hwpx/equation/render.py",
     "src/hwpx/tools/document_viewer.py",
+    "src/hwpx/tools/mail_merge.py",
+    "src/hwpx/tools/redline.py",
     "src/hwpx/_document/_units.py",
     "src/hwpx/_document/fields.py",
     "src/hwpx/_document/layout.py",
@@ -187,9 +212,6 @@ include = [
     "src/hwpx/_document/persistence.py",
     "src/hwpx/_document/shapes.py",
     "src/hwpx/_document/tracked.py",
-    "src/hwpx/agent/commands.py",
-    "src/hwpx/agent/document.py",
-    "src/hwpx/agent/story.py",
     "src/hwpx/oxml/_document_impl.py",
     "src/hwpx/oxml/_document_primitives.py",
     "src/hwpx/oxml/document.py",
@@ -208,6 +230,7 @@ include = [
     "src/hwpx/oxml/simple_parts.py",
     "src/hwpx/oxml/table.py",
     "src/hwpx/quality/policy.py",
+    "src/hwpx/quality/rendering.py",
     "src/hwpx/quality/report.py",
     "src/hwpx/tools/archive_cli.py",
     "src/hwpx/tools/package_validator.py",
@@ -215,7 +238,6 @@ include = [
     "src/hwpx/tools/template_analyzer.py",
     "src/hwpx/tools/text_extract_cli.py",
     "src/hwpx/tools/text_extractor.py",
-    "src/hwpx/visual/oracle.py",
     "tests/template_automation/helpers.py",
     "tests/template_automation/generate_fixtures.py",
 ]