python-hwpx-automation 7.0.3__tar.gz → 7.1.0__tar.gz

{python_hwpx_automation-7.0.3/src/python_hwpx_automation.egg-info → python_hwpx_automation-7.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 7.0.3
+Version: 7.1.0
 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.3.0
+Requires-Dist: python-hwpx<7,>=6.4.0
 Requires-Dist: pydantic<3,>=2.11
 Requires-Dist: cryptography>=42.0
 Requires-Dist: anyio>=4.0
@@ -74,15 +74,12 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 공개 트레인: `python-hwpx 6.2.1 → python-hwpx-automation 7.0.2 →
-> hwpx-plugin 2.0.1` — 7.0.3 트레인(core 6.3.0 · plugin 2.0.2)은 오너 발행
-> 승인 완료(`release-approved`), 원격 관찰 대기 중.
-> (automation 7.0.2 · plugin 2.0.1 released 2026-08-16,
-> Windows 저장 수리 패치 트레인 — 저장 수리 #98·업로드 경로 안내
-> #75, core와 계약 `34a91560759dc47a` 불변).
-> 공개 좌표는 원격 진실(core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치) 관찰 후에만
-> 승격됩니다 — [릴리스 runbook](docs/release-runbook.md)
+> 이 소스는 발행 승인된(release-approved) 7.1.0 후보입니다. 원격 발행과 실제 설치 관찰 전까지 공개 좌표는 유지합니다.
+> 후보: `python-hwpx 6.4.0 → python-hwpx-automation 7.1.0 → hwpx-plugin 2.2.0` (`ba0211fc854a0a97`).
+> 공개 트레인: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.4 → hwpx-plugin 2.1.0` (`8c278ebd5becba08`).
+> 공개 좌표는 core·automation PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
+> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -136,7 +133,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==7.0.3",
+        "python-hwpx-automation[mcp]==7.0.4",
         "hwpx-automation-mcp"
       ],
       "env": {
@@ -243,3 +240,5 @@ 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.0.3 → python_hwpx_automation-7.1.0}/README.md

@@ -14,15 +14,12 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 공개 트레인: `python-hwpx 6.2.1 → python-hwpx-automation 7.0.2 →
-> hwpx-plugin 2.0.1` — 7.0.3 트레인(core 6.3.0 · plugin 2.0.2)은 오너 발행
-> 승인 완료(`release-approved`), 원격 관찰 대기 중.
-> (automation 7.0.2 · plugin 2.0.1 released 2026-08-16,
-> Windows 저장 수리 패치 트레인 — 저장 수리 #98·업로드 경로 안내
-> #75, core와 계약 `34a91560759dc47a` 불변).
-> 공개 좌표는 원격 진실(core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치) 관찰 후에만
-> 승격됩니다 — [릴리스 runbook](docs/release-runbook.md)
+> 이 소스는 발행 승인된(release-approved) 7.1.0 후보입니다. 원격 발행과 실제 설치 관찰 전까지 공개 좌표는 유지합니다.
+> 후보: `python-hwpx 6.4.0 → python-hwpx-automation 7.1.0 → hwpx-plugin 2.2.0` (`ba0211fc854a0a97`).
+> 공개 트레인: `python-hwpx 6.3.0 → python-hwpx-automation 7.0.4 → hwpx-plugin 2.1.0` (`8c278ebd5becba08`).
+> 공개 좌표는 core·automation PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
+> [릴리스 runbook](docs/release-runbook.md)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.
@@ -76,7 +73,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==7.0.3",
+        "python-hwpx-automation[mcp]==7.0.4",
         "hwpx-automation-mcp"
       ],
       "env": {
@@ -183,3 +180,5 @@ 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.0.3 → python_hwpx_automation-7.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "7.0.3"
+version = "7.1.0"
 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.3.0,<7", # HWPX object model, OXML/OPC, format-native primitives
+    "python-hwpx>=6.4.0,<7", # HWPX object model, OXML/OPC, format-native primitives
 
     "pydantic>=2.11,<3",
     "cryptography>=42.0",

{python_hwpx_automation-7.0.3 → python_hwpx_automation-7.1.0}/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.3 → python_hwpx_automation-7.1.0}/src/hwpx_automation/handlers/read_export.py

@@ -38,6 +38,7 @@ from ..upstream import (
     open_document,
 )
 from ..utils.helpers import default_max_chars, resolve_path, truncate_response
+from ..utils.read_budget import bound_document_summary
 from ._shared import _with_document_state
 
 _OUTPUT_MODES = {"full", "chunks"}
@@ -920,7 +921,8 @@ def get_document_map(
             "hwpx_extract_json",
         ],
     }
-    return _with_document_state(result, path)
+    result = _with_document_state(result, path)
+    return bound_document_summary(result) if summary_mode else result
 
 
 def hwpx_to_markdown(

{python_hwpx_automation-7.0.3 → python_hwpx_automation-7.1.0}/src/hwpx_automation/identity.json

@@ -5,22 +5,29 @@
   "releaseState": {
     "status": "release-approved",
     "candidate": {
-      "pythonHwpx": "6.3.0",
+      "pythonHwpx": "6.4.0",
       "canonicalDistribution": "python-hwpx-automation",
-      "canonicalAutomation": "7.0.3",
+      "canonicalAutomation": "7.1.0",
       "compatibilityDistribution": "hwpx-mcp-server",
-      "compatibility": "7.0.3",
-      "plugin": "2.0.2",
-      "contractHash": "8c278ebd5becba08"
+      "compatibility": "7.1.0",
+      "plugin": "2.2.0",
+      "contractHash": "ba0211fc854a0a97"
     },
     "currentPublic": {
-      "pythonHwpx": "6.2.1",
+      "pythonHwpx": "6.3.0",
       "primaryDistribution": "python-hwpx-automation",
-      "primaryApplication": "7.0.2",
-      "plugin": "2.0.1",
-      "contractHash": "34a91560759dc47a"
+      "primaryApplication": "7.0.4",
+      "plugin": "2.1.0",
+      "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."
+    "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.3.0",
+      "primaryDistribution": "python-hwpx-automation",
+      "primaryApplication": "7.0.4",
+      "plugin": "2.1.0",
+      "contractHash": "8c278ebd5becba08"
+    }
   },
   "releaseFloors": {
     "description": "Frozen historical coordinates. Unlike releaseState these do not advance train by train; they pin the pre-6.0 legacy compatibility cap that every core 5 resolution must be observed against. They live here so the release path has no version literal that is not declared data.",

{python_hwpx_automation-7.0.3 → python_hwpx_automation-7.1.0}/src/hwpx_automation/office/agent/cli.py

@@ -23,6 +23,10 @@ from .blueprint import (
 )
 from .commands import apply_document_commands
 from .document import HwpxAgentDocument
+from .form_plan import (
+    MIXED_FORM_PLAN_SCHEMA, MIXED_FORM_COMPILED_PLAN_SCHEMA,
+    apply_mixed_form_fill, apply_mixed_form_plan,
+)
 from .model import (
     AGENT_BATCH_SCHEMA,
     AgentBatchResult,
@@ -536,6 +540,15 @@ def _run_replay(args: argparse.Namespace, *, stdin: TextIO, stdout: TextIO) -> i
     return _exit_code(result.error)
 
 
+def _apply_batch_request(request: Mapping[str, Any], store: dict[str, Any]) -> AgentBatchResult:
+    schema = request.get("schemaVersion")
+    if schema == MIXED_FORM_PLAN_SCHEMA:
+        return apply_mixed_form_fill(request, idempotency_store=store)
+    if schema == MIXED_FORM_COMPILED_PLAN_SCHEMA:
+        return apply_mixed_form_plan(request, idempotency_store=store)
+    return apply_document_commands(request, idempotency_store=store)
+
+
 def _run_mutation(
     args: argparse.Namespace,
     *,
@@ -550,7 +563,7 @@ def _run_mutation(
     exit_code = EXIT_OK
     results: list[AgentBatchResult] = []
     for request in requests:
-        result = apply_document_commands(request, idempotency_store=store)
+        result = _apply_batch_request(request, store)
         results.append(result)
         exit_code = max(exit_code, _exit_code(result.error))
     if args.output_format == "human":

{python_hwpx_automation-7.0.3 → python_hwpx_automation-7.1.0}/src/hwpx_automation/office/agent/document.py

@@ -21,7 +21,7 @@ from .model import (
     AgentNode,
     NODE_PROPERTY_CATALOG_V1,
 )
-from .path import SemanticPath, canonicalize_path, identified_segment, indexed_segment
+from .path import SemanticPath, canonicalize_path, identified_segment, indexed_segment, parse_path
 from .query import QueryRecord as _QueryRecord
 from .query import QueryResult, evaluate_selector, parse_selector
 from .story import (
@@ -804,9 +804,37 @@ class HwpxAgentDocument:
                 f"childLimit must be 1..{MAX_CHILDREN_PER_NODE}",
                 target="childLimit",
             )
-        record = self.resolve_record(path, expected_revision=expected_revision)
+        try:
+            record = self.resolve_record(path, expected_revision=expected_revision)
+        except AgentContractError as exc:
+            if exc.code != "not_found":
+                raise
+            record = self._resolve_indexed_read_path(path, expected_revision)
         return self._public_node(record, depth=depth, child_limit=child_limit)
 
+    def _resolve_indexed_read_path(self, path: str, revision: str | None) -> NodeRecord:
+        """Navigate omitted children; return a canonical path for subsequent edits.
+
+        Only get() calls this helper. Commands continue to require the exact
+        canonical path, so a navigation alias never silently retargets a write.
+        """
+        record = self._records["/"]
+        for segment in parse_path(path).segments:
+            direct = record.path.rstrip("/") + "/" + segment.canonical()
+            if direct in record.child_paths:
+                record = self.resolve_record(direct, expected_revision=revision)
+                continue
+            children = [self._records[p] for p in record.child_paths
+                        if self._records[p].kind == segment.kind]
+            if segment.index is None or segment.index > len(children):
+                raise AgentContractError("not_found", "indexed read target not found", target=path)
+            if revision is None:
+                raise AgentContractError(
+                    "volatile_target", "indexed navigation requires the current revision", target=path
+                )
+            record = self.resolve_record(children[segment.index - 1].path, expected_revision=revision)
+        return record
+
     def query(
         self,
         selector: str,

{python_hwpx_automation-7.0.3 → python_hwpx_automation-7.1.0}/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.3 → python_hwpx_automation-7.1.0}/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.3 → python_hwpx_automation-7.1.0}/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.3 → python_hwpx_automation-7.1.0}/src/hwpx_automation/office/rendering/_render_hwpx_mac.applescript

@@ -30,6 +30,10 @@ property closeDocPrefix : "문서 닫기"
 
 on run argv
 	if (count of argv) < 2 then return "ERR: usage: <input.hwpx> <out.pdf> [timeoutSecs]"
+	if item 1 of argv is "--close-owned" then
+		closeOwnedDocument(item 2 of argv)
+		return "CLEANUP"
+	end if
 	set inputPath to item 1 of argv
 	set outPdf to item 2 of argv
 	set timeoutSecs to 90
@@ -41,6 +45,18 @@ on run argv
 
 	set inputBase to do shell script "basename " & quoted form of inputPath
 
+	if listContains(windowNames(), inputBase) then return "ERR: staged document already open"
+	if listContains(windowNames(), pdfDialogTitle) then return "ERR: existing PDF dialog"
+	-- Do not drive menus while another document owns a modal sheet.
+	tell application "System Events"
+		if exists process procName then
+			tell process procName
+				repeat with w in windows
+					if (count of sheets of w) > 0 then return "ERR: existing modal sheet"
+				end repeat
+			end tell
+		end if
+	end tell
 	try
 		-- 1) Open the staged input. LaunchServices focuses Hancom (launching it
 		--    if needed) and opens the document.
@@ -61,7 +77,7 @@ on run argv
 
 		-- 4) Wait for the export dialog.
 		if not (waitForWindowNamed(pdfDialogTitle, 30)) then
-			return "ERR: PDF save dialog did not appear"
+			error "PDF save dialog did not appear"
 		end if
 		delay 1.0
 
@@ -94,19 +110,14 @@ on run argv
 		-- 8) Always close the document so the next render starts from a clean
 		--    session, even if the wait above was noisy. Discard any save-changes
 		--    prompt (we only exported; the doc content is unmodified).
-		try
-			clickFileMenuItemByPrefix(closeDocPrefix)
-			dismissCloseSheetIfPresent()
-		end try
+		set closed to closeOwnedDocument(inputBase)
+		if not closed then return "ERR: owned document cleanup incomplete"
 
 		if not wrote then return "ERR: PDF not written to " & outPdf
 		return "OK"
 	on error errMsg number errNum
 		-- Best-effort cleanup so a mid-flow error doesn't leak an open document.
-		try
-			clickFileMenuItemByPrefix(closeDocPrefix)
-			dismissCloseSheetIfPresent()
-		end try
+		closeOwnedDocument(inputBase)
 		return "ERR: " & errMsg & " (" & errNum & ")"
 	end try
 end run
@@ -221,29 +232,30 @@ on dismissOverwriteSheetIfPresent()
 	return false
 end dismissOverwriteSheetIfPresent
 
--- If closing surfaces a save-changes sheet, discard (저장 안 함 / 안 함). We only
--- exported a PDF, so the document content is unchanged.
-on dismissCloseSheetIfPresent()
-	repeat 6 times
-		set handled to false
-		try
-			tell application "System Events" to tell process procName
-				repeat with wn in windowNames()
-					set w to (first window whose name is (wn as string))
-					if (count of sheets of w) > 0 then
-						repeat with b in buttons of (sheet 1 of w)
-							set bn to (name of b as string)
-							if bn contains "안 함" or bn contains "안함" then
-								click b
-								set handled to true
-							end if
-						end repeat
-					end if
-				end repeat
-			end tell
-		end try
-		if handled then return true
-		delay 0.3
-	end repeat
-	return false
-end dismissCloseSheetIfPresent
+-- Never discard a sheet belonging to any other document. If ownership cannot
+-- be proved, leave the GUI for the user and report failure rather than kill it.
+on closeOwnedDocument(winName)
+    if not listContains(windowNames(), winName) then return false
+    if listContains(windowNames(), pdfDialogTitle) then return false
+    try
+        raiseWindowNamed(winName)
+        tell application "System Events" to tell process procName
+            if name of front window is not winName then return false
+        end tell
+        clickFileMenuItemByPrefix(closeDocPrefix)
+        tell application "System Events" to tell process procName
+            if exists (first window whose name is winName) then
+                set owned to (first window whose name is winName)
+                if (count of sheets of owned) > 0 then
+                    repeat with b in buttons of sheet 1 of owned
+                        set bn to name of b as string
+                        if bn contains "안 함" or bn contains "안함" then click b
+                    end repeat
+                end if
+            end if
+        end tell
+        return waitForWindowGone(winName, 2)
+    on error
+        return false
+    end try
+end closeOwnedDocument

{python_hwpx_automation-7.0.3 → python_hwpx_automation-7.1.0}/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.1.0/src/hwpx_automation/office/rendering/mac_session.py

@@ -0,0 +1,87 @@
+# SPDX-License-Identifier: Apache-2.0
+"""Owned, cancellable Mac GUI adapter for the existing serialized worker."""
+from __future__ import annotations
+
+import os
+import plistlib
+import subprocess
+import tempfile
+import threading
+from pathlib import Path
+
+from .oracle import MacHancomOracle
+
+
+class _OwnedMacOracle(MacHancomOracle):
+    def __init__(self, *, timeout: float) -> None:
+        super().__init__(timeout=timeout, budget_seconds=timeout)
+        self.guard = threading.Lock()
+        self.process: subprocess.Popen[str] | None = None
+        self.cancelled = threading.Event()
+
+    def _run_render_script(self, cmd: list[str], timeout: float) -> subprocess.CompletedProcess[str]:
+        with self.guard:
+            if self.cancelled.is_set():
+                raise OSError("render cancelled before launch")
+            process = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+            self.process = process
+        try:
+            try:
+                stdout, stderr = process.communicate(timeout=timeout)
+            except subprocess.TimeoutExpired:
+                process.kill()
+                process.communicate()
+                raise
+            if self.cancelled.is_set():
+                raise OSError("render cancelled")
+            return subprocess.CompletedProcess(cmd, process.returncode, stdout, stderr)
+        finally:
+            with self.guard:
+                self.process = None
+
+    def abort(self) -> None:
+        self.cancelled.set()
+        with self.guard:
+            if self.process is not None and self.process.poll() is None:
+                self.process.kill()  # our osascript only; never the user's app
+
+
+class MacHancomSession:
+    real_hancom = True
+    backend = "mac-gui-worker"
+
+    def __init__(self, *, timeout_seconds: float = 120) -> None:
+        self.oracle = _OwnedMacOracle(timeout=timeout_seconds)
+        app = self.oracle._app_path()
+        if app is None or not self.oracle.available():
+            raise RuntimeError("MAC_HANCOM_UNAVAILABLE")
+        with (Path(app) / "Contents/Info.plist").open("rb") as handle:
+            info = plistlib.load(handle)
+        version, build = info.get("CFBundleShortVersionString"), info.get("CFBundleVersion")
+        if not version or not build:
+            raise RuntimeError("MAC_HANCOM_BUILD_UNKNOWN")
+        self.hancom_build = f"{version} ({build})"
+
+    def render_pdf(self, source: Path, target: Path) -> Path | None:
+        from hwpx_automation.workflow.render_queue import inspect_hwpx
+        inspect_hwpx(source.read_bytes(), filename=source.name, principal_id="local-worker")
+        # The Mac desktop is shared even across worker roots/processes. flock
+        # lives until the rendering/owned cleanup exits, including watchdogs.
+        import fcntl
+        lock = Path(tempfile.gettempdir()) / f"hwpx-hancom-gui-{os.getuid()}.lock"
+        with lock.open("a") as handle:
+            try:
+                fcntl.flock(handle, fcntl.LOCK_EX | fcntl.LOCK_NB)
+            except BlockingIOError:
+                raise RuntimeError("MAC_GUI_BUSY") from None
+            try:
+                result = self.oracle.render_pdf(str(source), str(target))
+                return Path(result) if result else None
+            finally:
+                fcntl.flock(handle, fcntl.LOCK_UN)
+
+    def abort(self) -> None:
+        self.oracle.abort()
+
+    def close(self) -> None:
+        self.abort()