python-hwpx-automation 7.3.1__tar.gz → 7.3.3__tar.gz

{python_hwpx_automation-7.3.1/src/python_hwpx_automation.egg-info → python_hwpx_automation-7.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 7.3.1
+Version: 7.3.3
 Summary: Task-oriented HWPX document automation for Python, with an optional MCP adapter.
 Author: Kohkyuhyun
 License-Expression: Apache-2.0
@@ -74,12 +74,10 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 발행이 승인된 7.3.1 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.5.0 → python-hwpx-automation 7.3.1 → hwpx-plugin 2.3.0` (`5e5c23651f92785a`).
-> 공개 트레인: `python-hwpx 6.5.0 → python-hwpx-automation 7.2.0 → hwpx-plugin 2.3.0` (`5e5c23651f92785a`).
-> [발행·설치 영수증](docs/releases/2026-09-22-trustworthy-edit-engine.md)
+> 발행이 승인된 7.3.3 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.3 → hwpx-plugin 2.4.0` (`5e5c23651f92785a`).
+> 공개 트레인: `python-hwpx 6.6.0 → python-hwpx-automation 7.3.1 → hwpx-plugin 2.4.0`.
 > 공개 좌표는 core·automation PyPI와 plugin GitHub
 > Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
-> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -133,7 +131,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==7.2.0",
+        "python-hwpx-automation[mcp]==7.3.1",
         "hwpx-automation-mcp"
       ],
       "env": {
@@ -152,10 +150,10 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 
 > 비-HWPX 문서(PDF/DOCX/XLSX/HTML/TXT)를 `document_to_markdown`으로 읽으려면
 > `pip install "python-hwpx-automation[ingest]"`로 MarkItDown adapter를 함께
-> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 5.0.0`.
+> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 6.5.0`.
 
-기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 6.x 동안 그대로 동작합니다 —
-전체 목록과 유지 규칙: [6.x 호환 표면](docs/compatibility-6x.md)
+기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 그대로 동작합니다 —
+전체 목록과 유지 규칙: [호환 표면](docs/compatibility-6x.md)
 
 ## 한컴으로 PDF 렌더하기
 
@@ -164,7 +162,7 @@ PDF와 쪽 PNG로 렌더합니다. 별도 환경에서 실행하므로 호출하
 고정 버전을 건드리지 않습니다.
 
 ```bash
-uvx --from "python-hwpx-automation[oracle]==7.3.1" \
+uvx --from "python-hwpx-automation[oracle]==7.3.3" \
   hwpx render-pdf in.hwpx out.pdf --png out/page --json
 ```
 
@@ -185,7 +183,8 @@ JSON 결과·종료 코드·플랫폼 요구 사항: [render-pdf](docs/render-pd
 
 ## 안전하게 쓰는 법
 
-처음부터 모든 도구를 외울 필요는 없습니다. 보통 이렇게 흘러갑니다.
+처음부터 모든 도구를 외울 필요는 없습니다. 기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를,
+새 문서는 document-plan을 먼저 봅니다. 보통 이렇게 흘러갑니다.
 
 1. **읽기** — `get_document_info` → `get_document_outline`/`get_document_text` → `find_text`, `get_table_map`으로 필요한 부분만 파악합니다. (저장하지 않음)
 2. **안전 수정** — `copy_document`로 사본을 만들고, 가장 작은 변경(`search_and_replace`, `set_table_cell_text`, `apply_document_commands`)을 적용한 뒤 다시 읽어 확인하고, 검토가 끝난 사본을 전달합니다.
@@ -198,7 +197,7 @@ JSON 결과·종료 코드·플랫폼 요구 사항: [render-pdf](docs/render-pd
 열림안전을 검사하고, 게이트가 실패하면 아무것도 쓰지 않습니다. capability
 handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단합니다.
 보안 상세: [하드닝 가이드](docs/hardening_guide_ko.md) · 옛 이름과의 호환
-식별자: [6.x 호환 표면](docs/compatibility-6x.md)
+식별자: [호환 표면](docs/compatibility-6x.md)
 
 > **위치 계약** — `paragraph_index`는 본문 직속 문단의 0-based 인덱스입니다. 표 안 문단은 여기 섞지 않고
 > `{"kind":"table_cell_paragraph","table_index":0,"row":0,"col":1,"cell_paragraph_index":0}` 같은 `location`
@@ -219,10 +218,10 @@ handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단
 | `HWPX_AUTOMATION_WORKFLOW_STORE` | durable workflow SQLite 경로. 기존 `HWPX_WORKFLOW_STORE`보다 우선 | 기존 6.x 상태 경로 |
 | `LOG_LEVEL` | 로그 레벨 | `INFO` |
 
-동일 suffix의 기존 `HWPX_MCP_*` 키는 6.x 동안 fallback으로 유지되며, 두 키가
+동일 suffix의 기존 `HWPX_MCP_*` 키는 fallback으로 유지되며, 두 키가
 함께 있으면 `HWPX_AUTOMATION_*`이 우선합니다. render·workflow·oracle·plugin
 연동용 보존 키 전체 목록과 workflow DB 경로 규칙은
-[6.x 호환 표면](docs/compatibility-6x.md)에 있습니다.
+[호환 표면](docs/compatibility-6x.md)에 있습니다.
 
 경로는 기본적으로 workspace 밖 traversal과 symlink escape를 거부하고, URL 입력은 HTTPS·공개 IP만
 허용합니다. 원자 rename을 제공하지 않는 호스트의 동시성 주의사항은 [하드닝 가이드](docs/hardening_guide_ko.md)를 보세요.
@@ -253,5 +252,3 @@ python scripts/run_conformance.py run \
 ## License · Maintainer
 
 Apache-2.0 ([LICENSE](LICENSE) · [NOTICE](NOTICE)) — **Kohkyuhyun** [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
-
-기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를 먼저 확인하세요. 새 문서는 document-plan, 에이전트 연결은 선택 MCP와 호스트 플러그인을 사용합니다.

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/README.md

@@ -14,12 +14,10 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 발행이 승인된 7.3.1 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.5.0 → python-hwpx-automation 7.3.1 → hwpx-plugin 2.3.0` (`5e5c23651f92785a`).
-> 공개 트레인: `python-hwpx 6.5.0 → python-hwpx-automation 7.2.0 → hwpx-plugin 2.3.0` (`5e5c23651f92785a`).
-> [발행·설치 영수증](docs/releases/2026-09-22-trustworthy-edit-engine.md)
+> 발행이 승인된 7.3.3 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.3 → hwpx-plugin 2.4.0` (`5e5c23651f92785a`).
+> 공개 트레인: `python-hwpx 6.6.0 → python-hwpx-automation 7.3.1 → hwpx-plugin 2.4.0`.
 > 공개 좌표는 core·automation PyPI와 plugin GitHub
 > Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
-> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -73,7 +71,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==7.2.0",
+        "python-hwpx-automation[mcp]==7.3.1",
         "hwpx-automation-mcp"
       ],
       "env": {
@@ -92,10 +90,10 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
 
 > 비-HWPX 문서(PDF/DOCX/XLSX/HTML/TXT)를 `document_to_markdown`으로 읽으려면
 > `pip install "python-hwpx-automation[ingest]"`로 MarkItDown adapter를 함께
-> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 5.0.0`.
+> 설치합니다. 요구 사항: `Python >= 3.10` · `python-hwpx >= 6.5.0`.
 
-기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 6.x 동안 그대로 동작합니다 —
-전체 목록과 유지 규칙: [6.x 호환 표면](docs/compatibility-6x.md)
+기존 `hwpx-mcp-server` 배포·import·콘솔·설정 키도 그대로 동작합니다 —
+전체 목록과 유지 규칙: [호환 표면](docs/compatibility-6x.md)
 
 ## 한컴으로 PDF 렌더하기
 
@@ -104,7 +102,7 @@ PDF와 쪽 PNG로 렌더합니다. 별도 환경에서 실행하므로 호출하
 고정 버전을 건드리지 않습니다.
 
 ```bash
-uvx --from "python-hwpx-automation[oracle]==7.3.1" \
+uvx --from "python-hwpx-automation[oracle]==7.3.3" \
   hwpx render-pdf in.hwpx out.pdf --png out/page --json
 ```
 
@@ -125,7 +123,8 @@ JSON 결과·종료 코드·플랫폼 요구 사항: [render-pdf](docs/render-pd
 
 ## 안전하게 쓰는 법
 
-처음부터 모든 도구를 외울 필요는 없습니다. 보통 이렇게 흘러갑니다.
+처음부터 모든 도구를 외울 필요는 없습니다. 기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를,
+새 문서는 document-plan을 먼저 봅니다. 보통 이렇게 흘러갑니다.
 
 1. **읽기** — `get_document_info` → `get_document_outline`/`get_document_text` → `find_text`, `get_table_map`으로 필요한 부분만 파악합니다. (저장하지 않음)
 2. **안전 수정** — `copy_document`로 사본을 만들고, 가장 작은 변경(`search_and_replace`, `set_table_cell_text`, `apply_document_commands`)을 적용한 뒤 다시 읽어 확인하고, 검토가 끝난 사본을 전달합니다.
@@ -138,7 +137,7 @@ JSON 결과·종료 코드·플랫폼 요구 사항: [render-pdf](docs/render-pd
 열림안전을 검사하고, 게이트가 실패하면 아무것도 쓰지 않습니다. capability
 handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단합니다.
 보안 상세: [하드닝 가이드](docs/hardening_guide_ko.md) · 옛 이름과의 호환
-식별자: [6.x 호환 표면](docs/compatibility-6x.md)
+식별자: [호환 표면](docs/compatibility-6x.md)
 
 > **위치 계약** — `paragraph_index`는 본문 직속 문단의 0-based 인덱스입니다. 표 안 문단은 여기 섞지 않고
 > `{"kind":"table_cell_paragraph","table_index":0,"row":0,"col":1,"cell_paragraph_index":0}` 같은 `location`
@@ -159,10 +158,10 @@ handshake는 core/automation/plugin 버전+해시 skew를 fail-closed로 차단
 | `HWPX_AUTOMATION_WORKFLOW_STORE` | durable workflow SQLite 경로. 기존 `HWPX_WORKFLOW_STORE`보다 우선 | 기존 6.x 상태 경로 |
 | `LOG_LEVEL` | 로그 레벨 | `INFO` |
 
-동일 suffix의 기존 `HWPX_MCP_*` 키는 6.x 동안 fallback으로 유지되며, 두 키가
+동일 suffix의 기존 `HWPX_MCP_*` 키는 fallback으로 유지되며, 두 키가
 함께 있으면 `HWPX_AUTOMATION_*`이 우선합니다. render·workflow·oracle·plugin
 연동용 보존 키 전체 목록과 workflow DB 경로 규칙은
-[6.x 호환 표면](docs/compatibility-6x.md)에 있습니다.
+[호환 표면](docs/compatibility-6x.md)에 있습니다.
 
 경로는 기본적으로 workspace 밖 traversal과 symlink escape를 거부하고, URL 입력은 HTTPS·공개 IP만
 허용합니다. 원자 rename을 제공하지 않는 호스트의 동시성 주의사항은 [하드닝 가이드](docs/hardening_guide_ko.md)를 보세요.
@@ -193,5 +192,3 @@ python scripts/run_conformance.py run \
 ## License · Maintainer
 
 Apache-2.0 ([LICENSE](LICENSE) · [NOTICE](NOTICE)) — **Kohkyuhyun** [@airmang](https://github.com/airmang) · [kokyuhyun@hotmail.com](mailto:kokyuhyun@hotmail.com)
-
-기존 문서 수정은 [조회·대상 확정·보존 저장·검증 안내](docs/existing-edit-navigation.md)를 먼저 확인하세요. 새 문서는 document-plan, 에이전트 연결은 선택 MCP와 호스트 플러그인을 사용합니다.

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "7.3.1"
+version = "7.3.3"
 description = "Task-oriented HWPX document automation for Python, with an optional MCP adapter."
 readme = "README.md"
 authors = [{ name = "Kohkyuhyun" }]

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/core/content.py

@@ -14,8 +14,15 @@ from uuid import uuid4
 from xml.etree import ElementTree as ET
 
 from ..compat import patch_python_hwpx
-from ..storage import build_hwpx_open_safety_report
-from ..upstream import HP_NS as _HP_NS, HwpxDocument, repair_pathological_text_spacing
+from ..storage import build_hwpx_open_safety_report, open_local_document
+from ..upstream import (
+    HP_NS as _HP_NS,
+    HwpxDocument,
+    is_hwp5_source,
+    is_hwp5_target,
+    repair_pathological_text_spacing,
+)
+from .document import save_doc
 from .formatting import resolve_style_id
 from .locations import resolve_paragraph_reference
 
@@ -500,6 +507,15 @@ def copy_document_file(source: str, destination: str = None) -> str:
         destination = f"{stem}_copy.{ext}"
     source_path = Path(source)
     destination_path = Path(destination)
+    if is_hwp5_source(source_path) != is_hwp5_target(destination_path):
+        # The destination extension picks the format, so a copy between .hwp
+        # and .hwpx is written through the document model, not byte-copied.
+        document = open_local_document(source_path, role="copy source")
+        try:
+            save_doc(document, str(destination_path))
+        finally:
+            document.close()
+        return str(destination_path)
     if source_path.suffix.lower() != ".hwpx" and destination_path.suffix.lower() != ".hwpx":
         shutil.copy2(source_path, destination_path)
         return str(destination_path)

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/core/document.py

@@ -5,7 +5,7 @@ from pathlib import Path
 from typing import Any
 
 from ..configuration import env_value
-from ..storage import LocalDocumentStorage, require_hwpx_editor_open_safe
+from ..storage import LocalDocumentStorage, open_local_document
 from ..upstream import HwpxDocument, blank_document_template_bytes, open_document
 
 
@@ -18,8 +18,7 @@ def _local_storage() -> LocalDocumentStorage:
 def open_doc(path: str) -> HwpxDocument:
     if not os.path.exists(path):
         raise FileNotFoundError(f"파일을 찾을 수 없습니다: {path}")
-    require_hwpx_editor_open_safe(Path(path), role="local HWPX open")
-    return open_document(path)
+    return open_local_document(Path(path), role="local HWPX open")
 
 
 def save_doc(doc: HwpxDocument, path: str, *, quality: Any = None) -> dict[str, Any]:

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/core/transactions.py

@@ -12,8 +12,12 @@ from pathlib import Path
 from typing import Any, Iterable
 
 from .. import quality as quality_contract
-from ..storage import build_hwpx_verification_report, require_hwpx_editor_open_safe
-from ..upstream import HwpxDocument, open_document
+from ..storage import (
+    build_hwpx_verification_report,
+    require_hwpx_editor_open_safe,
+    require_native_hwp5,
+)
+from ..upstream import HwpxDocument, hwp5_document_bytes, is_hwp5_target, open_document
 
 _MAX_SUMMARY_ITEMS = 20
 _MAX_SNIPPET = 80
@@ -341,9 +345,13 @@ def save_dry_run(
     document: HwpxDocument, target: str | Path, *, quality: Any = None
 ) -> dict[str, Any]:
     target_path = Path(target)
+    hwp_target = is_hwp5_target(target_path)
+    if hwp_target:
+        require_native_hwp5()
+    # The gate checks HWPX parts, so an .hwp target is staged as HWPX.
     fd, tmp_name = tempfile.mkstemp(
         prefix=f".{target_path.stem}.dry-run.",
-        suffix=target_path.suffix or ".hwpx",
+        suffix=".hwpx" if hwp_target else (target_path.suffix or ".hwpx"),
         dir=str(target_path.parent),
     )
     tmp_path = Path(tmp_name)
@@ -366,6 +374,10 @@ def save_dry_run(
                 "dry-run HWPX failed open-safety verification: "
                 + verification["openSafety"]["summary"]
             )
+        if hwp_target:
+            # Raises Hwp5Error (hwp5-write-unsupported) as the real save would.
+            hwp5_document_bytes(document)
+            verification["format"] = "hwp"
         diff = semantic_diff(target_path, tmp_path) if target_path.exists() else None
         verification["filePath"] = str(target_path)
         verification["dryRunTempDeleted"] = True

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/errors.py

@@ -73,6 +73,7 @@ DEFAULT_ERROR_SUGGESTIONS: dict[str, str] = {
     "EMPTY_MATCH": "찾을 텍스트나 앵커 조건을 실제 문서 내용에 맞게 수정하세요.",
     "HWP_CONVERSION_FAILED": "원본 HWP가 손상되지 않았는지 확인하고 변환 로그의 원인을 기준으로 다시 시도하세요.",
     "HWP_TEXT_EXTRACT_FAILED": "HWP 파일을 다른 뷰어에서 열어 유효성을 확인한 뒤 텍스트 추출을 다시 실행하세요.",
+    "HWPX_PACKAGE_REQUIRED": "copy_document로 .hwpx 사본을 만들어 이 도구를 쓰고, .hwp가 필요하면 결과를 copy_document로 .hwp 경로에 복사하세요. search_and_replace·set_table_cell_text 같은 문서 편집 도구는 .hwp를 그대로 편집합니다.",
     "IDEMPOTENT_REPLAY": "이미 적용된 planId입니다. 최신 preview/plan을 새로 만든 뒤 apply를 다시 호출하세요.",
     "MEMO_NOT_FOUND": "list_memos 또는 문서 리소스에서 memoId를 다시 확인한 뒤 호출하세요.",
     "MISSING_NODE": "대상 섹션, 문단, 표, 셀이 아직 존재하는지 조회한 뒤 새 앵커로 다시 실행하세요.",
@@ -81,7 +82,10 @@ DEFAULT_ERROR_SUGGESTIONS: dict[str, str] = {
     "PIPELINE_ERROR": "details.pipelineCode와 hint를 확인한 뒤 preview부터 다시 생성하세요.",
     "PLAN_RECORD_MISSING": "preview_edit 또는 plan_edit으로 planId를 새로 발급받은 뒤 apply를 다시 호출하세요.",
     "PREVIEW_REQUIRED": "preview_edit으로 변경 내용을 확인한 뒤 반환된 planId로 apply_edit을 호출하세요.",
-    "READ_ONLY_HWP_DOCUMENT": "HWP 바이너리는 직접 저장할 수 없습니다. 먼저 HWPX로 변환한 뒤 편집하세요.",
+    "HWP_DOCUMENT_UNREADABLE": "한/글에서 문서를 열어 다시 저장한 뒤 사용하세요. details.hwp5Code가 원인입니다.",
+    "HWP_ENCRYPTED_DOCUMENT": "한/글에서 문서 암호·배포용 보호를 풀고 다시 저장한 뒤 사용하세요. DRM 문서는 열 수 없습니다.",
+    "HWP_WRITE_UNSUPPORTED": "HWP 5.0으로 쓸 수 없는 내용이 있습니다. 출력 경로를 .hwpx로 지정해 저장하세요.",
+    "READ_ONLY_HWP_DOCUMENT": "python-hwpx 6.6.0 이상을 설치하면 .hwp 문서를 그대로 열고 편집·저장할 수 있습니다.",
     "RENDER_PREVIEW_INVALID_MODE": "mode는 'pages' 또는 'long'으로 지정한 뒤 다시 실행하세요.",
     "RENDER_PREVIEW_INVALID_SCREENSHOT_MODE": "screenshot은 'auto', 'require', 'off' 중 하나로 지정하세요.",
     "RENDER_PREVIEW_UNAVAILABLE": "matching python-hwpx 버전을 설치하고 MCP 서버를 새로 시작한 뒤 다시 실행하세요.",
@@ -175,3 +179,52 @@ def build_error_payload(
         suggestion=suggestion
         or suggestion_for_error(code, details=details, hint=hint),
     ).model_dump(exclude_none=True, by_alias=True)
+
+
+class HwpDocumentError(RuntimeError):
+    """An ``.hwp`` request the installed engine cannot carry out."""
+
+    def __init__(
+        self, message: str, *, code: str, details: Optional[Dict[str, Any]] = None
+    ) -> None:
+        super().__init__(message)
+        self.code = code
+        self.message = message
+        self.details = details
+
+    def to_payload(self) -> Dict[str, Any]:
+        return build_error_payload(
+            code=self.code, message=self.message, details=self.details
+        )
+
+
+_HWP5_ENCRYPTED_CODES = frozenset({"hwp5-password", "hwp5-distribution", "hwp5-drm"})
+
+
+def hwp5_error_payload(exc: BaseException) -> Optional[Dict[str, Any]]:
+    """The MCP error for python-hwpx's ``Hwp5Error``; None for any other exception.
+
+    Matched by its ``hwp5-*`` code so this module needs no core import.
+    """
+
+    hwp5_code = getattr(exc, "code", None)
+    if not isinstance(hwp5_code, str) or not hwp5_code.startswith("hwp5-"):
+        return None
+    details = {"hwp5Code": hwp5_code}
+    if hwp5_code == "hwp5-write-unsupported":
+        return build_error_payload(
+            code="HWP_WRITE_UNSUPPORTED",
+            message="문서에 HWP 5.0(.hwp)으로 쓸 수 없는 내용이 있어 아무것도 저장하지 않았습니다.",
+            details=details,
+        )
+    if hwp5_code in _HWP5_ENCRYPTED_CODES:
+        return build_error_payload(
+            code="HWP_ENCRYPTED_DOCUMENT",
+            message="암호·배포용·DRM으로 보호된 HWP 문서는 열 수 없습니다.",
+            details=details,
+        )
+    return build_error_payload(
+        code="HWP_DOCUMENT_UNREADABLE",
+        message="HWP 5.0(.hwp) 문서를 읽을 수 없습니다.",
+        details=details,
+    )

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/handlers/agent_document.py

@@ -9,6 +9,8 @@ from typing import Any
 
 
 from ..document_state import document_state_payload
+from ..errors import HwpDocumentError
+from ..storage import require_hwpx_package
 from ..agent_document import (
     AgentChildLimit,
     AgentCommandList,
@@ -100,6 +102,7 @@ def apply_document_commands(
     try:
         resolved_input = resolve_path(filename)
         resolved_output = resolve_path(output)
+        require_hwpx_package(resolved_input, output=resolved_output)
         quality_contract.assert_write_capability()
         store = ScopedIdempotencyStore(
             RUNTIME_SERVICES.idempotency_cache,
@@ -132,6 +135,8 @@ def apply_document_commands(
         if Path(state_path).exists():
             payload.update(document_state_payload(state_path))
         return payload
+    except HwpDocumentError:
+        raise
     except Exception as exc:
         return agent_batch_error_payload(
             exc,

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/handlers/read_export.py

@@ -35,6 +35,7 @@ from ..office.compliance import DEFAULT_POLICY, mask_pii
 from ..runtime_services import RUNTIME_SERVICES
 from ..upstream import (
     HP_NS,
+    hwp5_conversion_report,
     open_document,
 )
 from ..utils.helpers import default_max_chars, resolve_path, truncate_response
@@ -777,16 +778,19 @@ def get_document_info(filename: str) -> dict:
     path = resolve_path(filename)
     doc = open_doc(path)
     file_size = Path(path).stat().st_size
-    return _with_document_state(
-        {
-            "filename": filename,
-            "sections": len(doc.sections),
-            "paragraphs": _paragraph_count(doc),
-            "tables": _table_count(doc),
-            "file_size": str(file_size),
-        },
-        path,
-    )
+    info: dict[str, Any] = {
+        "filename": filename,
+        "sections": len(doc.sections),
+        "paragraphs": _paragraph_count(doc),
+        "tables": _table_count(doc),
+        "file_size": str(file_size),
+    }
+    conversion = hwp5_conversion_report(doc)
+    if conversion is not None:
+        # An .hwp is edited through the document model; this is what it left out.
+        info["format"] = "hwp"
+        info["hwpConversion"] = conversion
+    return _with_document_state(info, path)
 
 
 def get_document_text(

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/identity.json

@@ -5,27 +5,27 @@
   "releaseState": {
     "status": "release-approved",
     "candidate": {
-      "pythonHwpx": "6.5.0",
+      "pythonHwpx": "6.6.0",
       "canonicalDistribution": "python-hwpx-automation",
-      "canonicalAutomation": "7.3.1",
+      "canonicalAutomation": "7.3.3",
       "compatibilityDistribution": "hwpx-mcp-server",
-      "compatibility": "7.3.1",
-      "plugin": "2.3.0",
+      "compatibility": "7.3.3",
+      "plugin": "2.4.0",
       "contractHash": "5e5c23651f92785a"
     },
     "currentPublic": {
-      "pythonHwpx": "6.5.0",
+      "pythonHwpx": "6.6.0",
       "primaryDistribution": "python-hwpx-automation",
-      "primaryApplication": "7.2.0",
-      "plugin": "2.3.0",
+      "primaryApplication": "7.3.1",
+      "plugin": "2.4.0",
       "contractHash": "5e5c23651f92785a"
     },
     "promotionGate": "Three states are mandatory: unreleased-candidate while auditing; release-approved only after separate owner approval and while currentPublic still names the previously observed coherent stack; released only in a follow-up commit after remote truth is observed for core, canonical automation, the compatibility distribution, the plugin GitHub release, the marketplace entry, and a real marketplace install. The automation tag workflow publishes only release-approved, leaves currentPublic unchanged, and hands an attached receipt to plugin publication.",
     "previousPublic": {
-      "pythonHwpx": "6.5.0",
+      "pythonHwpx": "6.6.0",
       "primaryDistribution": "python-hwpx-automation",
-      "primaryApplication": "7.2.0",
-      "plugin": "2.3.0",
+      "primaryApplication": "7.3.1",
+      "plugin": "2.4.0",
       "contractHash": "5e5c23651f92785a"
     },
     "publicationEvidence": null

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/mixed_form.py

@@ -41,7 +41,7 @@ from pydantic import (
 from .execution_lock import PUBLIC_MUTATION_LOCK
 from .office.agent._batch_publication import GuardedSavePipeline
 from .office.rendering import resolve_hancom_backend
-from .storage import build_hwpx_open_safety_report
+from .storage import build_hwpx_open_safety_report, require_hwpx_package
 from .utils.helpers import resolve_path
 from .workspace import (
     WorkspaceMissingParentGuard,
@@ -1374,6 +1374,7 @@ def analyze_mixed_form_plan(
 
     request = _authorize_public_plan(_payload(plan, apply=False))
     source = Path(request["source"])
+    require_hwpx_package(source, output=request["output"])
     source_snapshot = _capture_path_snapshot(source)
     if source_snapshot.data is None:
         raise FileNotFoundError(source)
@@ -1494,6 +1495,7 @@ def _apply_canonical_mixed_form_plan_locked(
 
     compiled = validate_mixed_form_plan(compiled).to_dict()
     source, output = _authorize_compiled_plan(compiled)
+    require_hwpx_package(source, output=output)
     source_snapshot = _capture_path_snapshot(source)
     if source_snapshot.data is None:  # pragma: no cover - compiled plan invariant
         raise FileNotFoundError(source)

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/office/authoring/report_parser.py

@@ -85,14 +85,9 @@ def parse_government_report_text(text: str, *, title: str = "") -> dict[str, Any
     flush_bullets()
     flush_table()
 
-    if not blocks:
-        fallback = normalize_cell_text(title) or "본문"
-        blocks.append({"type": "paragraph", "text": fallback})
-
-    metadata: dict[str, str] = {}
     normalized_title = normalize_cell_text(title)
-    if normalized_title:
-        metadata["title"] = normalized_title
+    metadata = {"title": normalized_title} if normalized_title else {}
+    blocks = _with_title_block(blocks, normalized_title) or [{"type": "paragraph", "text": "본문"}]
 
     return {
         "schemaVersion": DOCUMENT_PLAN_V2_SCHEMA_VERSION,
@@ -102,6 +97,23 @@ def parse_government_report_text(text: str, *, title: str = "") -> dict[str, Any
     }
 
 
+def _with_title_block(blocks: list[dict[str, Any]], title: str) -> list[dict[str, Any]]:
+    """Put *title* at the top of the body as a centred bold paragraph.
+
+    The plan title and metadata go to the document properties, not the body, so
+    a report shows its title only through a body block. A first line that
+    already is the title becomes that block instead of a copy.
+    """
+
+    if not title:
+        return blocks
+    rest = blocks
+    if rest and rest[0].get("type") in {"paragraph", "heading"} and rest[0].get("text") == title:
+        rest = rest[1:]
+    title_block = {"type": "paragraph", "align": "center", "runs": [{"text": title, "bold": True}]}
+    return [title_block, *rest]
+
+
 def _parse_heading(line: str) -> tuple[int, str] | None:
     markdown_match = _MARKDOWN_HEADING_RE.match(line)
     if markdown_match:

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/office/rendering/_hancom_open_rate.ps1

@@ -124,13 +124,35 @@ function Copy-ToTrustedTemp {
     return @{ Directory = $dir; Path = $target }
 }
 
-function New-HwpObject {
-    $hwp = New-Object -ComObject "HWPFrame.HwpObject"
+function Register-FilePathCheck {
+    # True when Hancom accepted a file-path check module. The module name is a
+    # value name under HKCU\SOFTWARE\HNC\HwpAutomation\Modules:
+    # HWPX_HANCOM_SECURITY_MODULE first, then Hancom's example name, then every
+    # other value registered there. The module type is always "FilePathCheckDLL".
+    param($Hwp)
+    $names = New-Object System.Collections.Generic.List[string]
+    if ($env:HWPX_HANCOM_SECURITY_MODULE) { $names.Add([string]$env:HWPX_HANCOM_SECURITY_MODULE) }
+    if (-not $names.Contains("FilePathCheckerModuleExample")) { $names.Add("FilePathCheckerModuleExample") }
     try {
-        $null = $hwp.RegisterModule("FilePathCheckerModule", "FilePathCheckerModuleExample")
-    } catch {
-        Write-Warning ("RegisterModule FilePathCheckerModule failed: " + $_.Exception.Message)
+        $key = Get-Item -LiteralPath "HKCU:\SOFTWARE\HNC\HwpAutomation\Modules" -ErrorAction Stop
+        foreach ($name in $key.GetValueNames()) {
+            if ($name -and -not $names.Contains($name)) { $names.Add($name) }
+        }
+    } catch {}
+    foreach ($name in $names) {
+        try {
+            if ([bool]$Hwp.RegisterModule("FilePathCheckDLL", $name)) { return $true }
+        } catch {}
     }
+    return $false
+}
+
+function New-HwpObject {
+    $hwp = New-Object -ComObject "HWPFrame.HwpObject"
+    # Inputs are opened from a copy in %TEMP% (Copy-ToTrustedTemp), which Hancom
+    # opens without its access-approval prompt. A registered file-path check
+    # module is used as well when there is one.
+    $null = Register-FilePathCheck $hwp
     # FR-002a: suppress modal dialogs. The negative controls (FR-005) prove the
     # suppressed default action is NOT silent auto-repair.
     try { $null = $hwp.SetMessageBoxMode($MESSAGE_BOX_MODE) } catch {

{python_hwpx_automation-7.3.1 → python_hwpx_automation-7.3.3}/src/hwpx_automation/office/rendering/_refresh_hwpx_mac.applescript

@@ -98,7 +98,10 @@ end windowNames
 
 on listContains(theList, theValue)
 	repeat with x in theList
-		if (x as string) is theValue then return true
+		-- a window without a title (missing value) cannot become a string
+		try
+			if (x as string) is theValue then return true
+		end try
 	end repeat
 	return false
 end listContains