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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 7.3.1
+Version: 7.3.2
 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.2 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.2 → 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.2" \
   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.2}/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.2 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.2 → 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.2" \
   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.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "7.3.1"
+version = "7.3.2"
 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.2}/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.2",
       "compatibilityDistribution": "hwpx-mcp-server",
-      "compatibility": "7.3.1",
-      "plugin": "2.3.0",
+      "compatibility": "7.3.2",
+      "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.2}/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.2}/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.2}/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

python_hwpx_automation-7.3.2/src/hwpx_automation/office/rendering/_render_hwpx.ps1

@@ -0,0 +1,148 @@
+<#
+.SYNOPSIS
+    Render .hwpx files to PDF via the Hancom (한글) COM automation object.
+
+.DESCRIPTION
+    The COM backend for hwpx.visual.RenderOracle. Reads a JSON job list
+    ([{ "src": "...", "pdf": "..." }, ...]) so many file paths (incl. Korean
+    names) survive without argument-quoting issues, opens each through
+    HWPFrame.HwpObject, exports to PDF, and writes a JSON result array.
+    A job may name its output "out" instead of "pdf" and carry a SaveAs
+    "format" other than "PDF" (WindowsComOracle.refresh_document saves
+    "HWPX"); such a document is laid out before it is saved.
+
+    Hancom Office 2022 (v12) exposes Open with a fixed (filename, format, arg)
+    signature -- the 1-arg form fails to bind, so pass ("", "") for auto-detect.
+    SaveAs(path, "PDF", "") works as-is.
+
+    File access: Hancom asks the user to approve every automated open or save
+    of a file outside the user's temporary folder unless a file-path check
+    module is registered. Nobody answers that prompt in an automated run, so
+    the caller stages every job's "src" and "pdf" under a private folder in
+    %TEMP% (WindowsComOracle does). A module registered under
+    HKCU\SOFTWARE\HNC\HwpAutomation\Modules is registered here as well, with
+    the module type "FilePathCheckDLL"; each result records whether that
+    succeeded ("registered").
+
+.PARAMETER Jobs
+    Path to the JSON job-list file (UTF-8).
+
+.PARAMETER ResultPath
+    Optional path to write the JSON result array to; otherwise written to stdout.
+
+.PARAMETER PidPath
+    Optional path to write this render's own Hancom process to, as JSON
+    {"pid": N, "started": "<UTC start time>"}, right after the COM object is
+    created. The caller ends that process, and only it, when the render
+    outlives its timeout: Hancom runs as a COM server, not as a child of this
+    script, so ending the script leaves it running.
+#>
+param(
+    [Parameter(Mandatory = $true)][string] $Jobs,
+    [string] $ResultPath = "",
+    [string] $PidPath = ""
+)
+
+$ErrorActionPreference = "Stop"
+try { [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 } catch {}
+
+function Write-OwnHancom {
+    # Record the one automation Hwp.exe that appeared while the COM object was
+    # created. Nothing is recorded when that is ambiguous.
+    param([int[]] $Before, [string] $Path)
+    $new = @(Get-Process -Name Hwp -ErrorAction SilentlyContinue | Where-Object { $Before -notcontains $_.Id })
+    $mine = @()
+    foreach ($process in $new) {
+        try {
+            $info = Get-CimInstance Win32_Process -Filter ("ProcessId=" + $process.Id) -ErrorAction Stop
+            if ([string]$info.CommandLine -match "-Automation") { $mine += $process }
+        } catch {}
+    }
+    if ($mine.Count -ne 1) { return }
+    $record = [ordered]@{
+        pid     = $mine[0].Id
+        started = $mine[0].StartTime.ToUniversalTime().ToString("o")
+    }
+    Set-Content -LiteralPath $Path -Value ($record | ConvertTo-Json -Compress) -Encoding UTF8
+}
+
+function Register-FilePathCheck {
+    # True when Hancom accepted a file-path check module. The module name is a
+    # value name under the Modules key: HWPX_HANCOM_SECURITY_MODULE first, then
+    # Hancom's example name, then every other value registered there.
+    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 {
+        $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
+}
+
+$jobList = Get-Content -LiteralPath $Jobs -Raw -Encoding UTF8 | ConvertFrom-Json
+$results = New-Object System.Collections.Generic.List[object]
+$hwp = $null
+try {
+    $before = @(Get-Process -Name Hwp -ErrorAction SilentlyContinue | ForEach-Object { $_.Id })
+    $hwp = New-Object -ComObject "HWPFrame.HwpObject"
+    if ($PidPath) {
+        try { Write-OwnHancom -Before $before -Path $PidPath } catch {}
+    }
+    $registered = Register-FilePathCheck $hwp
+    # Auto-dismiss modal dialogs so automation never blocks.
+    try { $null = $hwp.SetMessageBoxMode(0x00020000) } catch {}
+
+    foreach ($job in $jobList) {
+        $src = [string]$job.src
+        $pdf = [string]$job.pdf
+        if ($job.out) { $pdf = [string]$job.out }
+        $format = "PDF"
+        if ($job.format) { $format = [string]$job.format }
+        $opened = $false; $saved = $false; $err = $null
+        try {
+            $opened = [bool]$hwp.Open($src, "", "")
+            if ($opened) {
+                if ($format -ne "PDF") {
+                    # A hidden automation window lays nothing out until asked, and
+                    # an HWPX saved unlaid carries no line layout cache
+                    # (hp:linesegarray). Asking for the page count lays it out.
+                    $null = $hwp.PageCount
+                }
+                $saved = [bool]$hwp.SaveAs($pdf, $format, "")
+            }
+        } catch {
+            $err = $_.Exception.Message
+        } finally {
+            try { $hwp.Clear(1) | Out-Null } catch {}
+        }
+        $results.Add([ordered]@{
+            src        = $src
+            pdf        = $pdf
+            opened     = $opened
+            saved      = $saved
+            error      = $err
+            registered = $registered
+        })
+    }
+} finally {
+    if ($null -ne $hwp) {
+        try { $hwp.Quit() | Out-Null } catch {}
+        try { [System.Runtime.InteropServices.Marshal]::FinalReleaseComObject($hwp) | Out-Null } catch {}
+    }
+}
+
+$json = $results | ConvertTo-Json -Depth 5
+if ($ResultPath) {
+    Set-Content -LiteralPath $ResultPath -Value $json -Encoding UTF8
+} else {
+    $json
+}