python-hwpx-automation 7.0.2__tar.gz → 7.0.4__tar.gz

{python_hwpx_automation-7.0.2/src/python_hwpx_automation.egg-info → python_hwpx_automation-7.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 7.0.2
+Version: 7.0.4
 Summary: Task-oriented HWPX document automation for Python, with an optional MCP adapter.
 Author: Kohkyuhyun
 License-Expression: Apache-2.0
@@ -20,7 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: python-hwpx<7,>=6.0.2
+Requires-Dist: python-hwpx<7,>=6.3.0
 Requires-Dist: pydantic<3,>=2.11
 Requires-Dist: cryptography>=42.0
 Requires-Dist: anyio>=4.0
@@ -74,12 +74,13 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 공개 트레인: `python-hwpx 6.1.0 → python-hwpx-automation 7.0.1 →
-> hwpx-plugin 2.0.0`. automation 7.0.2 패치(Windows 저장 수리 #98,
-> 업로드 경로 안내 #75)가 release-approved 상태이며, 원격
-> 진실(core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치) 관찰 전까지 공개 좌표를
-> 승격하지 않습니다 — [릴리스 runbook](docs/release-runbook.md)
+> 아직 공개되지 않은 7.0.4 후보입니다.
+> 후보 조합: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.4 → hwpx-plugin 2.1.0`.
+> 공개 트레인: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.3 → hwpx-plugin 2.0.3`.
+> 계약은 `8c278ebd5becba08`이며 도구 표면과 최소 호환 버전은 유지합니다.
+> 공개 좌표는 core·automation PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
+> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -133,7 +134,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==6.1.3",
+        "python-hwpx-automation[mcp]==7.0.3",
         "hwpx-automation-mcp"
       ],
       "env": {

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/README.md

@@ -14,12 +14,13 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 공개 트레인: `python-hwpx 6.1.0 → python-hwpx-automation 7.0.1 →
-> hwpx-plugin 2.0.0`. automation 7.0.2 패치(Windows 저장 수리 #98,
-> 업로드 경로 안내 #75)가 release-approved 상태이며, 원격
-> 진실(core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치) 관찰 전까지 공개 좌표를
-> 승격하지 않습니다 — [릴리스 runbook](docs/release-runbook.md)
+> 아직 공개되지 않은 7.0.4 후보입니다.
+> 후보 조합: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.4 → hwpx-plugin 2.1.0`.
+> 공개 트레인: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.3 → hwpx-plugin 2.0.3`.
+> 계약은 `8c278ebd5becba08`이며 도구 표면과 최소 호환 버전은 유지합니다.
+> 공개 좌표는 core·automation PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
+> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -73,7 +74,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==6.1.3",
+        "python-hwpx-automation[mcp]==7.0.3",
         "hwpx-automation-mcp"
       ],
       "env": {

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "7.0.2"
+version = "7.0.4"
 description = "Task-oriented HWPX document automation for Python, with an optional MCP adapter."
 readme = "README.md"
 authors = [{ name = "Kohkyuhyun" }]
@@ -31,7 +31,7 @@ dependencies = [
     # breaking an already-published automation line. WP-F (engine surface 6.0):
     # this line adapted to the new namespace surface (design §9 WP-F) — the dev0
     # pre-release qualifier tracks core's own not-yet-tagged 6.0 identity.
-    "python-hwpx>=6.0.2,<7", # HWPX object model, OXML/OPC, format-native primitives
+    "python-hwpx>=6.3.0,<7", # HWPX object model, OXML/OPC, format-native primitives
 
     "pydantic>=2.11,<3",
     "cryptography>=42.0",

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/handlers/quality_render.py

@@ -272,6 +272,60 @@ def describe_capabilities(domain: str | None = None) -> dict:
     return report
 
 
+_STACK_UPDATE_STATE_SCHEMA = "hwpx.stack-update-state.v1"
+
+
+def _stack_update_block() -> dict[str, Any]:
+    """Launcher-managed runtime update state (hwpx-plugins Feature 066).
+
+    The bundled launcher writes update-state.json and passes its path as
+    HWPX_STACK_UPDATE_STATE. Without it the runtime is not launcher-managed
+    (pip install, editable checkout, plain uvx) and the block says so; it
+    never guesses.
+    """
+    path = os.environ.get("HWPX_STACK_UPDATE_STATE")
+    if not path:
+        return {"available": False, "reason": "NOT_MANAGED"}
+    try:
+        with open(path, encoding="utf-8") as handle:
+            state = json.load(handle)
+    except FileNotFoundError:
+        return {"available": False, "reason": "STATE_MISSING", "path": path}
+    except (OSError, UnicodeDecodeError, json.JSONDecodeError) as exc:
+        return {"available": False, "reason": "STATE_UNREADABLE", "path": path, "detail": str(exc)}
+    if not isinstance(state, dict) or state.get("schemaVersion") != _STACK_UPDATE_STATE_SCHEMA:
+        return {"available": False, "reason": "STATE_SCHEMA_UNKNOWN", "path": path}
+    runtime = state.get("runtime")
+    if not isinstance(runtime, dict):
+        return {"available": False, "reason": "STATE_INVALID", "path": path}
+    installed = runtime.get("installed")
+    if (
+        not isinstance(installed, dict)
+        or set(installed) != {"python-hwpx", "python-hwpx-automation"}
+        or not all(isinstance(value, str) and value for value in installed.values())
+    ):
+        return {"available": False, "reason": "STATE_INVALID", "path": path}
+    running = {
+        "python-hwpx": _package_version("python-hwpx"),
+        "python-hwpx-automation": _package_version("python-hwpx-automation"),
+    }
+    runtime = {
+        **runtime,
+        "running": running,
+        "restartRequired": runtime["installed"] != running,
+    }
+    return {
+        "available": True,
+        "path": path,
+        "checkedAt": state.get("checkedAt"),
+        "autoUpdate": state.get("autoUpdate"),
+        "channel": state.get("channel"),
+        "runtime": runtime,
+        "pluginBundle": state.get("pluginBundle"),
+        "lastError": state.get("lastError"),
+    }
+
+
 def mcp_server_health() -> dict:
     """MCP 서버 transport와 timeout/keepalive 점검 정보를 반환합니다."""
     transport = env_value("TRANSPORT", "stdio")
@@ -386,6 +440,7 @@ def mcp_server_health() -> dict:
             ),
         },
         "capability": _capability_block(skew_detected, surface_details),
+        "stackUpdate": _stack_update_block(),
         "unitPolicy": {
             "status": "audited",
             "fontSize": "points",

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/identity.json

@@ -5,20 +5,20 @@
   "releaseState": {
     "status": "release-approved",
     "candidate": {
-      "pythonHwpx": "6.1.0",
+      "pythonHwpx": "6.3.0",
       "canonicalDistribution": "python-hwpx-automation",
-      "canonicalAutomation": "7.0.2",
+      "canonicalAutomation": "7.0.4",
       "compatibilityDistribution": "hwpx-mcp-server",
-      "compatibility": "7.0.2",
-      "plugin": "2.0.0",
-      "contractHash": "34a91560759dc47a"
+      "compatibility": "7.0.4",
+      "plugin": "2.1.0",
+      "contractHash": "8c278ebd5becba08"
     },
     "currentPublic": {
-      "pythonHwpx": "6.1.0",
+      "pythonHwpx": "6.3.0",
       "primaryDistribution": "python-hwpx-automation",
-      "primaryApplication": "7.0.1",
-      "plugin": "2.0.0",
-      "contractHash": "34a91560759dc47a"
+      "primaryApplication": "7.0.3",
+      "plugin": "2.0.3",
+      "contractHash": "8c278ebd5becba08"
     },
     "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."
   },

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/office/agent/commands.py

@@ -1024,7 +1024,11 @@ def _identity_attribute_names(local: str, node: Any) -> tuple[str, ...]:
     if local in {"p", "tbl", "pic", "memo", "fieldBegin", *_SHAPE_KINDS}:
         return tuple(name for name in ("id", "instid", "instId") if node.get(name) is not None)
     if local in {"footNote", "endNote"}:
-        return tuple(name for name in ("instId", "id") if node.get(name) is not None)
+        # 정본 속성명은 실한컴이 쓰는 소문자 "instid"; "instId"는 과거 코어
+        # 저작이 방출한 카멜케이스 산출물 호환(재발급 대상 유지). #101
+        return tuple(
+            name for name in ("instid", "instId", "id") if node.get(name) is not None
+        )
     return ()
 
 
@@ -1036,7 +1040,11 @@ def _refresh_one_identity(
     field_ids: dict[str, str],
 ) -> None:
     names = _identity_attribute_names(local, node)
-    paired_identity = allocate() if len(names) > 1 and local in {"pic", *_SHAPE_KINDS} else None
+    # 한 요소에 실린 여러 식별 속성(id+instid, 또는 instid/instId 별칭 쌍)은
+    # 같은 정체성이다 — 하나의 새 값을 페어로 재발급한다. 노트(footNote/endNote)
+    # 는 정본 instid와 과거 산출물 instId가 공존할 수 있어 #101에서 편입.
+    paired_kinds = {"pic", "footNote", "endNote", *_SHAPE_KINDS}
+    paired_identity = allocate() if len(names) > 1 and local in paired_kinds else None
     for name in names:
         old = str(node.get(name))
         new = paired_identity or allocate()

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/office/authoring/__init__.py

@@ -1292,7 +1292,7 @@ def inspect_document_authoring_quality(
                     _rendered = _mac.render_pdf(str(_hwpx), str(_pdf))
                     if _rendered and Path(_rendered).exists():
                         try:
-                            import fitz as _fitz
+                            import pymupdf as _fitz
 
                             _doc = _fitz.open(_rendered)
                             _has_text = any(

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/office/form_fill/fit/wordbox.py

@@ -185,7 +185,7 @@ def fitz_available() -> bool:
     """True when PyMuPDF (``fitz``) can be imported (the extraction backend)."""
 
     try:  # pragma: no cover - trivial import probe
-        import fitz  # noqa: F401
+        import pymupdf as fitz  # noqa: F401
     except Exception:
         return False
     return True
@@ -205,7 +205,7 @@ def extract_word_boxes(pdf_path: str, *, page: int | None = None) -> list[WordBo
 
     if not fitz_available():
         raise OracleUnavailable("PyMuPDF (fitz) is not installed")
-    import fitz
+    import pymupdf as fitz
 
     boxes: list[WordBox] = []
     try:
@@ -255,7 +255,7 @@ def extract_glyph_boxes(pdf_path: str, *, page: int | None = None) -> list[WordB
 
     if not fitz_available():
         raise OracleUnavailable("PyMuPDF (fitz) is not installed")
-    import fitz
+    import pymupdf as fitz
 
     boxes: list[WordBox] = []
     try:
@@ -709,7 +709,7 @@ def render_glyph_boxes(
         if not pdf or not os.path.exists(pdf) or os.path.getsize(pdf) == 0:
             raise OracleUnavailable("Hancom render produced no PDF")
         boxes = extract_glyph_boxes(pdf, page=page)
-        import fitz
+        import pymupdf as fitz
 
         with fitz.open(pdf) as doc:
             if len(doc) == 0:  # a 0-page render is a failed render, not a clean pass
@@ -742,7 +742,7 @@ def extract_cell_clips(pdf_path: str, *, page: int | None = None) -> list[Rect]:
 
     if not fitz_available():
         raise OracleUnavailable("PyMuPDF (fitz) is not installed")
-    import fitz
+    import pymupdf as fitz
 
     clips: list[Rect] = []
     try:
@@ -785,7 +785,7 @@ def extract_image_boxes(pdf_path: str, *, page: int | None = None) -> list[Rect]
 
     if not fitz_available():
         raise OracleUnavailable("PyMuPDF (fitz) is not installed")
-    import fitz
+    import pymupdf as fitz
 
     boxes: list[Rect] = []
     try:
@@ -843,7 +843,7 @@ def render_form_geometry(
                 raise OracleUnavailable("Hancom render produced no PDF")
             glyphs = extract_glyph_boxes(rendered, page=page)
             clips = extract_cell_clips(rendered, page=page)
-            import fitz
+            import pymupdf as fitz
 
             with fitz.open(rendered) as doc:
                 if len(doc) == 0:
@@ -957,7 +957,7 @@ def extract_layout_signature(pdf_path: str) -> LayoutSignature:
 
     if not fitz_available():
         raise OracleUnavailable("PyMuPDF (fitz) is not installed")
-    import fitz
+    import pymupdf as fitz
 
     try:
         doc = fitz.open(pdf_path)

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/office/form_fill/quality.py

@@ -180,7 +180,7 @@ def detect_overflow_crossings(
     PyMuPDF; raises ``RuntimeError`` if unavailable (caller degrades to unverified).
     """
     try:
-        import fitz
+        import pymupdf as fitz
     except Exception as exc:  # pragma: no cover - env probe
         raise RuntimeError(f"PyMuPDF unavailable: {exc}") from exc
 
@@ -266,7 +266,7 @@ def score_render(
             [f"render imaging deps unavailable: {exc}"],
         )
 
-    import fitz  # already importable if we got here
+    import pymupdf as fitz  # already importable if we got here
 
     doc = fitz.open(pdf)
     pages = doc.page_count

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/office/rendering/diff.py

@@ -27,7 +27,7 @@ _TALL_BAND_REL = 1.0
 
 def pymupdf_available() -> bool:
     try:  # pragma: no cover - trivial import probe
-        import fitz  # noqa: F401
+        import pymupdf as fitz  # noqa: F401
     except Exception:
         return False
     return True
@@ -36,7 +36,7 @@ def pymupdf_available() -> bool:
 def render_pdf_to_images(pdf_path: str | Path, dpi: int = 150) -> list["Image.Image"]:
     """Rasterize every page of ``pdf_path`` to a list of RGB ``PIL.Image``."""
 
-    import fitz  # pymupdf
+    import pymupdf as fitz  # pymupdf
     from PIL import Image
 
     pages: list[Image.Image] = []

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/office/rendering/worker.py

@@ -255,7 +255,7 @@ class SerializedHancomWorker:
     @staticmethod
     def _rasterize(pdf: Path, destination: Path, dpi: int) -> list[Path]:
         try:
-            import fitz
+            import pymupdf as fitz
         except ImportError as exc:
             raise RuntimeError("PyMuPDF is required for page PNG output") from exc
         document = fitz.open(pdf)

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/hwpx_automation/tool_contract.py

@@ -20,7 +20,7 @@ from dataclasses import dataclass
 from enum import Enum
 from typing import Any, Callable, Mapping
 
-MIN_PYTHON_HWPX = "6.0.2"
+MIN_PYTHON_HWPX = "6.3.0"
 # The 5.0 train: core drops the workflow surfaces and the `hwpx` console name,
 # this package picks the name up, and the plugin pins both. The three move
 # together — a mixed set is what "no valid install has two declarers" rules out.
@@ -33,7 +33,7 @@ MIN_SKILL_VERSION = "2.0.0"
 # recomputes and verifies the bound callable/schema contract through
 # ``contract_hash()``; this constant prevents those services from importing the
 # runtime composer merely to stamp the approved release receipt.
-RELEASED_CONTRACT_HASH = "34a91560759dc47a"
+RELEASED_CONTRACT_HASH = "8c278ebd5becba08"
 
 
 def describe_callables(entries: Any) -> Any:

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4/src/python_hwpx_automation.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 7.0.2
+Version: 7.0.4
 Summary: Task-oriented HWPX document automation for Python, with an optional MCP adapter.
 Author: Kohkyuhyun
 License-Expression: Apache-2.0
@@ -20,7 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: python-hwpx<7,>=6.0.2
+Requires-Dist: python-hwpx<7,>=6.3.0
 Requires-Dist: pydantic<3,>=2.11
 Requires-Dist: cryptography>=42.0
 Requires-Dist: anyio>=4.0
@@ -74,12 +74,13 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 공개 트레인: `python-hwpx 6.1.0 → python-hwpx-automation 7.0.1 →
-> hwpx-plugin 2.0.0`. automation 7.0.2 패치(Windows 저장 수리 #98,
-> 업로드 경로 안내 #75)가 release-approved 상태이며, 원격
-> 진실(core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치) 관찰 전까지 공개 좌표를
-> 승격하지 않습니다 — [릴리스 runbook](docs/release-runbook.md)
+> 아직 공개되지 않은 7.0.4 후보입니다.
+> 후보 조합: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.4 → hwpx-plugin 2.1.0`.
+> 공개 트레인: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.3 → hwpx-plugin 2.0.3`.
+> 계약은 `8c278ebd5becba08`이며 도구 표면과 최소 호환 버전은 유지합니다.
+> 공개 좌표는 core·automation PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
+> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -133,7 +134,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==6.1.3",
+        "python-hwpx-automation[mcp]==7.0.3",
         "hwpx-automation-mcp"
       ],
       "env": {

{python_hwpx_automation-7.0.2 → python_hwpx_automation-7.0.4}/src/python_hwpx_automation.egg-info/requires.txt

@@ -1,4 +1,4 @@
-python-hwpx<7,>=6.0.2
+python-hwpx<7,>=6.3.0
 pydantic<3,>=2.11
 cryptography>=42.0
 anyio>=4.0