python-hwpx-automation 6.4.2__tar.gz → 6.6.4__tar.gz

{python_hwpx_automation-6.4.2/src/python_hwpx_automation.egg-info → python_hwpx_automation-6.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 6.4.2
+Version: 6.6.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<6,>=5.4.0
+Requires-Dist: python-hwpx<6,>=5.6.0
 Requires-Dist: pydantic<3,>=2.11
 Requires-Dist: cryptography>=42.0
 Requires-Dist: anyio>=4.0
@@ -74,15 +74,17 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 이 저장소의 main은 아직 공개되지 않은 6.4.2 후보 — release-approved 상태(표 테두리·음영
-> `format_table` 확장, 수리된 core 5.4.0 기본값, 계약 `dbdbdfaac26148b7`,
-> 130 도구)입니다. 현재 공개 트레인은
-> `python-hwpx 5.3.0 → python-hwpx-automation 6.3.1 → hwpx-plugin 1.3.0`
-> (계약 `236f8ea855c875fe`, 2026-07-31 released)입니다. 공개 트레인은
-> core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격했으며, 기존
-> 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태
-> 머신: [릴리스 runbook](docs/release-runbook.md)
+> 이 소스 트리는 **아직 공개되지 않은 6.6.4 후보**입니다(에이전트 계약 표면:
+> `run_edit_plan` 선언적 편집 계획 실행기 + MCP resources +
+> `describe_capabilities` 확장, 134 도구, core 바닥 5.6.0). 현재 공개
+> 트레인은 여전히 `python-hwpx 5.5.0 → python-hwpx-automation 6.5.1 → hwpx-plugin 1.5.0`
+> (계약 `f61d2c60c0aa0413`)이며, 후보는 core·automation
+> PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치까지 확인한 뒤에만 승격합니다.
+> 기존 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와
+> 상태 머신: [릴리스 runbook](docs/release-runbook.md)
+> 현재 상태는 release-approved입니다 — 원격 진실(3스택·marketplace 설치) 관찰 전까지
+> currentPublic은 그대로입니다.
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/README.md

@@ -14,15 +14,17 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 이 저장소의 main은 아직 공개되지 않은 6.4.2 후보 — release-approved 상태(표 테두리·음영
-> `format_table` 확장, 수리된 core 5.4.0 기본값, 계약 `dbdbdfaac26148b7`,
-> 130 도구)입니다. 현재 공개 트레인은
-> `python-hwpx 5.3.0 → python-hwpx-automation 6.3.1 → hwpx-plugin 1.3.0`
-> (계약 `236f8ea855c875fe`, 2026-07-31 released)입니다. 공개 트레인은
-> core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격했으며, 기존
-> 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태
-> 머신: [릴리스 runbook](docs/release-runbook.md)
+> 이 소스 트리는 **아직 공개되지 않은 6.6.4 후보**입니다(에이전트 계약 표면:
+> `run_edit_plan` 선언적 편집 계획 실행기 + MCP resources +
+> `describe_capabilities` 확장, 134 도구, core 바닥 5.6.0). 현재 공개
+> 트레인은 여전히 `python-hwpx 5.5.0 → python-hwpx-automation 6.5.1 → hwpx-plugin 1.5.0`
+> (계약 `f61d2c60c0aa0413`)이며, 후보는 core·automation
+> PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치까지 확인한 뒤에만 승격합니다.
+> 기존 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와
+> 상태 머신: [릴리스 runbook](docs/release-runbook.md)
+> 현재 상태는 release-approved입니다 — 원격 진실(3스택·marketplace 설치) 관찰 전까지
+> currentPublic은 그대로입니다.
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "6.4.2"
+version = "6.6.4"
 description = "Task-oriented HWPX document automation for Python, with an optional MCP adapter."
 readme = "README.md"
 authors = [{ name = "Kohkyuhyun" }]
@@ -29,7 +29,7 @@ dependencies = [
     # the bounded major here is what makes "no valid install has two declarers"
     # true rather than hopeful, and prevents the next core major from silently
     # breaking an already-published automation line.
-    "python-hwpx>=5.4.0,<6", # HWPX object model, OXML/OPC, format-native primitives
+    "python-hwpx>=5.6.0,<6", # HWPX object model, OXML/OPC, format-native primitives
 
     "pydantic>=2.11,<3",
     "cryptography>=42.0",

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/src/hwpx_automation/capabilities.py

@@ -107,4 +107,59 @@ def tool_domain(name: str) -> str | None:
     return None
 
 
-__all__ = ["DOMAINS", "build_capability_report", "coverage_against", "tool_domain"]
+def core_self_description() -> dict[str, Any]:
+    """설치된 core의 `hwpx.capabilities/v1` 자기서술 — 없으면 정직 degrade.
+
+    core 5.6+가 제공한다. 구버전 core 위에서는 없다는 사실 자체를 보고하지,
+    자기서술을 지어내지 않는다.
+    """
+
+    try:
+        from hwpx.experimental import describe_capabilities as core_caps
+    except ImportError:
+        return {
+            "available": False,
+            "reason": (
+                "installed python-hwpx does not expose hwpx.capabilities "
+                "(needs >= 5.6.0)"
+            ),
+        }
+    report = dict(core_caps())
+    report["available"] = True
+    return report
+
+
+def render_oracle_availability() -> dict[str, Any]:
+    """실한컴 렌더 오라클 가용성 — **무실행 프로브만**(세션·렌더 발사 없음).
+
+    resolve_oracle 캐스케이드(Windows COM → Mac GUI → Null; STRUCTURAL_ONLY는
+    Null 단락)와 imaging/pymupdf 프로브를 그대로 보고한다. available=False는
+    결함이 아니라 이 환경의 사실이며, 그때 render 게이트는 renderChecked=false
+    로 정직하게 degrade한다.
+    """
+
+    from .office.rendering import detectors, diff
+    from .office.rendering.oracle import resolve_oracle
+
+    oracle = resolve_oracle()
+    try:
+        available = bool(oracle.available())
+    except Exception:
+        available = False
+    return {
+        "oracle": type(oracle).__name__,
+        "available": available,
+        "imaging": bool(detectors.imaging_available()),
+        "pymupdf": bool(diff.pymupdf_available()),
+        "note": "probe-only — 어떤 렌더 세션도 시작하지 않는다",
+    }
+
+
+__all__ = [
+    "DOMAINS",
+    "build_capability_report",
+    "core_self_description",
+    "coverage_against",
+    "render_oracle_availability",
+    "tool_domain",
+]

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/src/hwpx_automation/fastmcp_adapter.py

@@ -616,6 +616,32 @@ def register_canonical_tool(
     return _register(mcp, name=name, func=func, description=description, meta=meta)
 
 
+def register_canonical_resource(
+    mcp: Any,
+    *,
+    uri: str,
+    name: str,
+    description: str,
+    mime_type: str,
+    func: Callable[[], str],
+) -> None:
+    """Register one canonical read-only resource through the public SDK hook.
+
+    이 어댑터가 유일한 FastMCP 호환 seam이라는 계약(모듈 docstring)은 리소스
+    표면에도 그대로 적용된다 — 다른 모듈은 이 함수를 부르지, SDK의
+    ``resource`` 데코레이터를 직접 만지지 않는다.
+    """
+
+    try:
+        mcp.resource(uri, name=name, description=description, mime_type=mime_type)(
+            func
+        )
+    except Exception as exc:  # pragma: no cover - SDK 계약 위반은 등록 시점 하드 실패
+        raise FastMcpAdapterError(
+            f"failed to register canonical resource {uri!r}: {exc}"
+        ) from exc
+
+
 def snapshot_runtime_tools(mcp: Any) -> Mapping[str, FastMcpToolSnapshot]:
     """Return an insertion-ordered, read-only snapshot of the live registry."""
 

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/src/hwpx_automation/handlers/form_fill.py

@@ -136,6 +136,32 @@ def apply_template_formfit(
     )
 
 
+def run_edit_plan(
+    plan: dict,
+    dry_run: bool = False,
+) -> dict:
+    """선언적 편집 계획(hwpx.edit-plan/v1)을 all-or-nothing으로 실행합니다.
+
+    plan.steps는 기존 바이트-스플라이스 op 이름 그대로(fill_cells·
+    apply_table_ops·apply_body_ops·paragraph_patch·recolor_runs_by_color·
+    strip_runs_by_color·strip_trailing_table_captions)를 지시합니다. 실행은
+    정적 선검증→전 체인 인메모리→최종 open-safety 검증→단 1회 원자 쓰기 —
+    중간 step 실패 시 output·source는 바이트 불변이고 ok=false 리포트
+    (failedStepId·step error)가 돌아옵니다. dry_run=true는 동일 체인을 전부
+    실행하되 쓰기만 생략합니다(미리보기=실행 정의상 동일). 반환은
+    hwpx.plan-report/v1(step별+원본→최종 mutation-report/v1 실측 사영 포함).
+    스키마는 hwpx://schemas/edit-plan-v1 리소스로 구독 가능합니다."""
+
+    resolved = dict(plan) if plan else {}
+    for key in ("source", "output", "journalPath"):
+        value = resolved.get(key)
+        if isinstance(value, str) and value:
+            resolved[key] = resolve_path(value)
+    if not dry_run:
+        quality_contract.assert_write_capability()
+    return RUNTIME_SERVICES.ops.run_edit_plan(resolved, dry_run=dry_run)
+
+
 def apply_table_ops(
     filename: str,
     ops: list[TableOperation],

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/src/hwpx_automation/handlers/quality_render.py

@@ -258,6 +258,17 @@ def describe_capabilities(domain: str | None = None) -> dict:
         advanced=advanced,
         registry_validation=validation,
     )
+    # additive(6.6): core 자기서술·오라클 가용성·리소스 카탈로그를 합성한다 —
+    # 자기서술 도구를 둘로 쪼개지 않는다(진실 이원화 방지).
+    from ..capabilities import core_self_description, render_oracle_availability
+    from ..resources import CANONICAL_RESOURCES
+
+    report["core"] = core_self_description()
+    report["renderOracle"] = render_oracle_availability()
+    report["resources"] = [
+        {"uri": spec.uri, "name": spec.name, "mimeType": spec.mime_type}
+        for spec in CANONICAL_RESOURCES
+    ]
     return report
 
 

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/src/hwpx_automation/handlers/specialized.py

@@ -7,7 +7,7 @@ import os
 import re
 import tempfile
 from pathlib import Path
-from typing import Any
+from typing import Any, Literal, cast
 
 from ..core.content import (
     collect_full_text,
@@ -23,6 +23,11 @@ from ..office.authoring.advanced_generators import (
     build_organization_chart as build_hwpx_organization_chart,
 )
 from ..office.compliance import DEFAULT_POLICY, detect_pii, mask_value
+from ..office.house_style import load_bank, load_genres
+from ..office.house_style.composition import (
+    compose_section_chip as compose_house_section_chip,
+)
+from ..office.house_style.org_chart import lower_boxed_org_chart
 from ..office.document_ops import (
     build_mail_merge as build_hwpx_mail_merge,
 )
@@ -217,6 +222,90 @@ def build_organization_chart(
     }
 
 
+def add_boxed_org_chart(
+    filename: str,
+    hierarchy: dict,
+    accent_color: str = None,
+    dry_run: bool = False,
+    expected_revision: str = None,
+) -> dict:
+    """계층 트리를 실물 관례의 박스 조직도(표 캔버스+병합 박스+셀 테두리
+    커넥터)로 문서 끝에 그립니다. 각 노드는 {"label", "sublabel"?,
+    "children"?[]} 매핑이며 깊이 4·박스 40 초과는 typed 거부.
+    accent_color는 루트 박스 배경색. dry_run=True이면 저장하지 않습니다."""
+    path = resolve_path(filename)
+    guard = _revision_guard(path, expected_revision)
+    if guard is not None:
+        return guard
+    doc = open_doc(path)
+    summary = lower_boxed_org_chart(doc, hierarchy or {}, accent_color=accent_color)
+    result = {"orgChart": summary}
+    if dry_run:
+        return _with_dry_run_verification(result, doc, path)
+    verification = _save_doc_verification(doc, path)
+    return _with_save_verification(result, verification)
+
+
+def compose_section_chip(
+    number: str,
+    title: str,
+    style: str = "box",
+    accent_color: str = None,
+) -> dict:
+    """운영계획 장르의 섹션 구분자(섹션칩)를 범용 document_plan block으로
+    합성합니다. style="box"(1×3 accent 칩) 또는 "inline"(번호 제목 헤딩).
+    파일은 쓰지 않습니다 — 반환 block을 document_plan에 끼워 넣으십시오."""
+    if style not in ("box", "inline"):
+        raise ValueError('style must be "box" or "inline"')
+    chip_style = cast('Literal["box", "inline"]', style)
+    block = compose_house_section_chip(
+        number, title, style=chip_style, accent_color=accent_color
+    )
+    result: dict = {"block": block, "next_tool": "validate_document_plan"}
+    if style == "box" and accent_color:
+        result["styling"] = {
+            "accentColor": accent_color,
+            "how": (
+                "문서 생성 후 이 칩 표의 번호 셀에 "
+                "format_table(fill_color=accentColor, row=0, col=0)을 적용"
+            ),
+        }
+    return result
+
+
+def get_genre_grammar(genre: str) -> dict:
+    """장르 구조 문법·타이포 역할(하우스 스타일 뱅크)을 반환하는 read-only
+    조회입니다. 스킬이 per-문서 인스턴스화(번호 체계·칩 렌더·블록 선택·색)
+    판단에 사용합니다. 미보유 장르는 사용 가능 목록과 함께 typed 거부."""
+    catalog = load_genres()
+    genres = catalog.genres if hasattr(catalog, "genres") else {}
+    if genre not in genres:
+        raise ValueError(
+            f"unknown genre {genre!r}; available: {sorted(genres)}"
+        )
+    bank = load_bank()
+    entry = genres[genre]
+    payload = entry if isinstance(entry, dict) else entry.model_dump()
+    inherits = None
+    typography = payload.get("typography") if isinstance(payload, dict) else None
+    if isinstance(typography, dict):
+        inherits = typography.get("inherits")
+    profiles = bank.profiles if hasattr(bank, "profiles") else {}
+    inherited_profile = None
+    if inherits and inherits in profiles:
+        base = profiles[inherits]
+        inherited_profile = base if isinstance(base, dict) else base.model_dump()
+    return {
+        "genre": genre,
+        "grammar": payload,
+        "inheritedProfile": {"name": inherits, "profile": inherited_profile}
+        if inherited_profile
+        else None,
+        "sectionChipTool": "compose_section_chip",
+        "orgChartTool": "add_boxed_org_chart",
+    }
+
+
 def scan_personal_info(filename: str | None = None, text: str | None = None) -> dict:
     """문서/텍스트의 개인정보(PII)를 탐지하는 read-only 감사 (원본값 미노출).
 

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/src/hwpx_automation/hwpx_ops.py

@@ -939,6 +939,14 @@ class HwpxOps:
             publication_sink=publication_sink,
         )
 
+    def run_edit_plan(
+        self,
+        plan: Dict[str, Any],
+        *,
+        dry_run: bool = False,
+    ) -> Dict[str, Any]:
+        return self._services.form_fields.run_edit_plan(plan, dry_run=dry_run)
+
     def apply_table_ops(
         self,
         path: str,

python_hwpx_automation-6.6.4/src/hwpx_automation/identity.json

@@ -0,0 +1,263 @@
+{
+  "schemaVersion": "python-hwpx-automation.identity/v1",
+  "product": "python-hwpx-automation",
+  "releaseMajor": 6,
+  "releaseState": {
+    "status": "release-approved",
+    "candidate": {
+      "pythonHwpx": "5.6.0",
+      "canonicalDistribution": "python-hwpx-automation",
+      "canonicalAutomation": "6.6.4",
+      "compatibilityDistribution": "hwpx-mcp-server",
+      "compatibility": "6.6.4",
+      "plugin": "1.6.0",
+      "contractHash": "19898dba41495c47"
+    },
+    "currentPublic": {
+      "pythonHwpx": "5.5.0",
+      "primaryDistribution": "python-hwpx-automation",
+      "primaryApplication": "6.5.1",
+      "plugin": "1.5.0",
+      "contractHash": "f61d2c60c0aa0413"
+    },
+    "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."
+  },
+  "identifiers": [
+    {
+      "surface": "repository",
+      "value": "airmang/python-hwpx-automation",
+      "classification": "canonical"
+    },
+    {
+      "surface": "distribution",
+      "value": "python-hwpx-automation",
+      "classification": "canonical"
+    },
+    {
+      "surface": "import-namespace",
+      "value": "hwpx_automation",
+      "classification": "canonical"
+    },
+    {
+      "surface": "task-console",
+      "value": "hwpx",
+      "classification": "canonical"
+    },
+    {
+      "surface": "mcp-console",
+      "value": "hwpx-automation-mcp",
+      "classification": "canonical"
+    },
+    {
+      "surface": "fastmcp-server-info-name",
+      "value": "python-hwpx-automation",
+      "classification": "canonical"
+    },
+    {
+      "surface": "host-config-key",
+      "value": "hwpx",
+      "classification": "host-local-alias"
+    },
+    {
+      "surface": "environment-prefix",
+      "value": "HWPX_AUTOMATION_",
+      "classification": "canonical"
+    },
+    {
+      "surface": "distribution",
+      "value": "hwpx-mcp-server",
+      "classification": "compatibility"
+    },
+    {
+      "surface": "import-namespace",
+      "value": "hwpx_mcp_server",
+      "classification": "compatibility"
+    },
+    {
+      "surface": "mcp-console",
+      "value": "hwpx-mcp-server",
+      "classification": "compatibility"
+    },
+    {
+      "surface": "environment-prefix",
+      "value": "HWPX_MCP_",
+      "classification": "compatibility"
+    },
+    {
+      "surface": "capability-version-field",
+      "value": "versions.automation",
+      "classification": "canonical"
+    },
+    {
+      "surface": "capability-version-field",
+      "value": "versions.mcp",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "capability-floor-field",
+      "value": "minAutomationVersion",
+      "classification": "canonical"
+    },
+    {
+      "surface": "capability-floor-field",
+      "value": "minMcpVersion",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "contract-floor-constant",
+      "value": "MIN_AUTOMATION_VERSION",
+      "classification": "canonical"
+    },
+    {
+      "surface": "contract-floor-constant",
+      "value": "MIN_MCP_VERSION",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "protocol-error-schema",
+      "value": "hwpx.mcp-error/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.authoring-runtime-owner/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.compliance-quality-utilities-owner/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.document-operations-owner/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.evalplan-runtime-owner/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.exam-runtime-owner/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.form-fill-runtime-owner/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.form-fill-runtime-parity/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-receipt-schema",
+      "value": "hwpx-mcp.visual-runtime-owner/v1",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "frozen-parity-receipt-field",
+      "value": "mcpRuntimeMembers",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "workflow-state-environment",
+      "value": "HWPX_AUTOMATION_WORKFLOW_STORE",
+      "classification": "canonical"
+    },
+    {
+      "surface": "workflow-state-environment",
+      "value": "HWPX_WORKFLOW_STORE",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "workflow-state-path",
+      "value": "${XDG_STATE_HOME:-~/.local/state}/hwpx-mcp-server/workflows.sqlite3",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "render-queue-principal",
+      "value": "hwpx-mcp-server",
+      "classification": "compatibility-preserved"
+    },
+    {
+      "surface": "render-integration-environment",
+      "value": "HWPX_RENDER_QUEUE_ROOT",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "render-integration-environment",
+      "value": "HWPX_RENDER_QUEUE_URL",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "render-integration-environment",
+      "value": "HWPX_RENDER_QUEUE_SECRET",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "render-integration-environment",
+      "value": "HWPX_RENDER_TRANSPORT_AUTH",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "render-integration-environment",
+      "value": "HWPX_RENDER_CA_FILE",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "render-integration-environment",
+      "value": "HWPX_RENDER_CLIENT_CERT_FILE",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "render-integration-environment",
+      "value": "HWPX_RENDER_CLIENT_KEY_FILE",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "workflow-security-environment",
+      "value": "HWPX_WORKFLOW_ENCRYPTION_KEY",
+      "classification": "capability-preserved"
+    },
+    {
+      "surface": "oracle-capability-environment",
+      "value": "HWPX_ORACLE_STRUCTURAL_ONLY",
+      "classification": "capability-preserved"
+    },
+    {
+      "surface": "oracle-capability-environment",
+      "value": "HWPX_ORACLE_BUDGET_SECONDS",
+      "classification": "capability-preserved"
+    },
+    {
+      "surface": "plugin-integration-environment",
+      "value": "HWPX_SKILL_VERSION",
+      "classification": "integration-preserved"
+    },
+    {
+      "surface": "plugin-integration-environment",
+      "value": "HWPX_PLUGIN_ROOT",
+      "classification": "integration-preserved"
+    }
+  ],
+  "compatibilityPolicy": {
+    "supportedThroughMajor": 6,
+    "removalNotBeforeMajor": 7,
+    "minimumPublicNoticeDays": 90,
+    "requiresObservedUsageWindow": true,
+    "requiresSeparateOwnerApproval": true,
+    "statePathMigrationInMajor6": false
+  },
+  "notes": {
+    "hostConfigKey": "The key is a host-local alias, not the MCP protocol identity.",
+    "environmentPrecedence": "HWPX_AUTOMATION_* wins; HWPX_MCP_* remains a 6.x fallback.",
+    "preservedWireIdentifiers": "The public hwpx.mcp-error/v1 schema, versions.mcp/minMcpVersion/MIN_MCP_VERSION aliases, frozen hwpx-mcp.* architecture receipt IDs, and mcpRuntimeMembers parity-receipt field remain exact in 6.x. They are compatibility identifiers, not statements that MCP owns the automation product.",
+    "preservedIntegrationEnvironment": "Product-neutral HWPX_RENDER_*, HWPX_WORKFLOW_ENCRYPTION_KEY, HWPX_ORACLE_*, HWPX_SKILL_VERSION, and HWPX_PLUGIN_ROOT names do not encode the former MCP product identity. They remain unchanged and are not aliases in the HWPX_AUTOMATION_ transition.",
+    "statePath": "HWPX_AUTOMATION_WORKFLOW_STORE wins over the prior HWPX_WORKFLOW_STORE override; the existing hwpx-mcp-server on-disk default remains in 6.x to avoid silent workflow loss.",
+    "renderQueuePrincipal": "The signed queue principal remains hwpx-mcp-server in 6.x so queued work and worker authorization do not split during the rename."
+  }
+}

{python_hwpx_automation-6.4.2 → python_hwpx_automation-6.6.4}/src/hwpx_automation/office/agent/blueprint/dump.py

@@ -276,6 +276,13 @@ def _host_run_path(record: NodeRecord, selected: Mapping[str, NodeRecord]) -> st
         run_element = candidate.native.element
         if parent is run_element or (element is not None and any(child is element for child in run_element)):
             return candidate.path
+        # core 5.5.0+: notes are ctrl-wrapped inside the run (the real-Hancom
+        # contract) — the run hosts the wrapper, one hop above the note.
+        if element is not None and any(
+            child.tag.endswith("}ctrl") and any(grand is element for grand in child)
+            for child in run_element
+        ):
+            return candidate.path
     return None