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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 6.7.1
+Version: 7.0.2
 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.7.0
+Requires-Dist: python-hwpx<7,>=6.0.2
 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]
-> 이 소스 트리는 **아직 공개되지 않은 6.7.1 후보**입니다(양식개체·기안문 장르:
-> 체크박스 저작 프리미티브와 `compose_official_draft`/`compose_simple_draft`,
-> 136 도구, core 바닥 5.7.0). 현재 공개 트레인은 여전히
-> `python-hwpx 5.6.0 → python-hwpx-automation 6.6.4 → hwpx-plugin 1.6.0`
-> (계약 `19898dba41495c47`)입니다.
-> 후보는 core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치까지 확인한 뒤에만 승격하며, 기존
-> 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태
-> 머신: [릴리스 runbook](docs/release-runbook.md)
+> 공개 트레인: `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)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.

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

@@ -14,15 +14,12 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 이 소스 트리는 **아직 공개되지 않은 6.7.1 후보**입니다(양식개체·기안문 장르:
-> 체크박스 저작 프리미티브와 `compose_official_draft`/`compose_simple_draft`,
-> 136 도구, core 바닥 5.7.0). 현재 공개 트레인은 여전히
-> `python-hwpx 5.6.0 → python-hwpx-automation 6.6.4 → hwpx-plugin 1.6.0`
-> (계약 `19898dba41495c47`)입니다.
-> 후보는 core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치까지 확인한 뒤에만 승격하며, 기존
-> 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태
-> 머신: [릴리스 runbook](docs/release-runbook.md)
+> 공개 트레인: `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)
 
 [python-hwpx](https://github.com/airmang/python-hwpx) 엔진 위에서 문서 저작·
 양식 채움·시험지 조판·안전한 에이전트 워크플로를 제공하는 응용 계층입니다.

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "6.7.1"
+version = "7.0.2"
 description = "Task-oriented HWPX document automation for Python, with an optional MCP adapter."
 readme = "README.md"
 authors = [{ name = "Kohkyuhyun" }]
@@ -24,12 +24,14 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    # 5.0 is the floor, not a preference: this package declares the `hwpx` console
+    # 6.0 is the floor, not a preference: this package declares the `hwpx` console
     # name that core used to own, and core only stops declaring it at 5.0. Pinning
     # 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.7.0,<6", # HWPX object model, OXML/OPC, format-native primitives
+    # 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
 
     "pydantic>=2.11,<3",
     "cryptography>=42.0",
@@ -124,6 +126,30 @@ include = ["hwpx_automation*"]
 # exercise, and their tests import them by bare name.
 pythonpath = ["src", "scripts"]
 addopts = "-q"
+# WP-F (core 6.0 namespace adaptation, design §9): any DeprecationWarning this
+# package's own code triggers by calling core's pre-7.0 legacy shim surface is
+# a real regression -- error by default, and name each known non-automation
+# source precisely rather than silencing DeprecationWarning wholesale.
+filterwarnings = [
+    "error::DeprecationWarning",
+    # hwpx-core's own internal modules still call its pre-6.0 facade
+    # internally (core's own migration debt, not automation's -- out of this
+    # package's control/scope).
+    "ignore::DeprecationWarning:hwpx\\._document\\._legacy",
+    "ignore::DeprecationWarning:hwpx\\.form_fit\\.measure",
+    "ignore::DeprecationWarning:hwpx\\.ingest\\.hwpx_converter",
+    "ignore::DeprecationWarning:hwpx\\.tools\\.mail_merge",
+    "ignore::DeprecationWarning:hwpx\\.tools\\.redline",
+    # test_fuzz_harness_wired dynamically imports whichever co-located
+    # python-hwpx* sibling checkout happens to carry scripts/fuzz (by design
+    # it does not pin to PYTHON_HWPX_REPO -- see that test's own docstring);
+    # that checkout's migration state is outside this package's control.
+    "ignore::DeprecationWarning:fuzz\\.runner",
+    # SWIG-generated C-extension types (from a rendering/test dependency)
+    # lack __module__ on some builtin types under newer CPython -- a
+    # third-party artifact, never an hwpx-sourced warning.
+    "ignore:builtin type \\w+ has no __module__ attribute:DeprecationWarning",
+]
 
 [tool.mypy]
 python_version = "3.10"

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/core/content.py

@@ -274,7 +274,9 @@ def delete_paragraph_from_doc(doc: HwpxDocument, paragraph_index: int) -> int:
         return total
 
     try:
-        doc.remove_paragraph(paragraph_index)
+        # remove_paragraph is demoted in 6.0 with no namespace replacement
+        # (design table row 101) — the paragraph object owns .remove() now.
+        paragraphs[paragraph_index].remove()
     except (ValueError, IndexError) as exc:
         raise RuntimeError("삭제할 문단 요소를 섹션에서 찾을 수 없습니다.") from exc
     return total - 1
@@ -317,19 +319,19 @@ def get_table_data(doc: HwpxDocument, table_index: int) -> dict:
 
 def get_table_map_in_doc(doc: HwpxDocument) -> dict:
     """문서의 표 메타데이터를 LLM 친화적인 JSON 형태로 반환한다."""
-    result = doc.get_table_map()
+    result = doc.tables.map()
     tables = list(result.get("tables", []))
     return {"tables": tables, "count": len(tables)}
 
 
 def find_cell_by_label_in_doc(doc: HwpxDocument, label_text: str, direction: str = "right") -> dict:
     """라벨 셀 기준으로 대상 셀을 찾는다."""
-    return doc.find_cell_by_label(label_text, direction=direction)
+    return doc.tables.find_cell_by_label(label_text, direction=direction)
 
 
 def fill_by_path_in_doc(doc: HwpxDocument, mappings: dict[str, str]) -> dict:
     """라벨 기반 경로 구문으로 표 셀을 채운다."""
-    return doc.fill_by_path(mappings)
+    return doc.tables.fill_by_path(mappings)
 
 
 def set_cell_text(
@@ -429,7 +431,7 @@ def _apply_table_border_fill(
     col: int = None,
 ) -> str:
     """테두리/음영 borderFill을 만들어 표 전체 또는 한 셀에 적용한다."""
-    border_fill_id = doc.ensure_border_fill(
+    border_fill_id = doc.styles.ensure_border_fill(
         border_type=border_type or "SOLID",
         border_color=border_color or "#000000",
         border_width=border_width or "0.12 mm",
@@ -736,20 +738,20 @@ def add_memo_to_doc(
         create=True,
     )
     paragraph = resolved.paragraph
-    memo_count_before = len(doc.memos)
+    memo_count_before = len(doc.notes.memos)
     try:
-        doc.add_memo_with_anchor(text or "", paragraph=paragraph)
+        doc.notes.add_memo(text or "", anchor=paragraph)
     except Exception as exc:  # noqa: BLE001
         if not _looks_like_mixed_xml_type_error(exc):
             raise
         # Clean up any partially-created memo from the failed native call
-        current_memos = doc.memos
+        current_memos = doc.notes.memos
         while len(current_memos) > memo_count_before:
             try:
-                doc.remove_memo(current_memos[-1])
+                doc.notes.remove_memo(current_memos[-1])
             except Exception:  # noqa: BLE001
                 break
-            current_memos = doc.memos
+            current_memos = doc.notes.memos
         logger.warning("메모 추가 중 혼합 XML 타입 충돌 감지, fallback 경로 사용: %s", exc)
         _add_memo_with_anchor_fallback(paragraph, text or "")
     return {"memo_added": True, "location": resolved.location}
@@ -775,9 +777,9 @@ def remove_memo_from_doc(
             if memo_id:
                 memo_ids.add(memo_id)
 
-    for memo in list(doc.memos):
+    for memo in list(doc.notes.memos):
         if memo.id in memo_ids:
-            doc.remove_memo(memo)
+            doc.notes.remove_memo(memo)
 
     removed_anchor = False
     for run_element in _memo_anchor_runs(paragraph, memo_ids):

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/core/formatting.py

@@ -406,10 +406,10 @@ def create_style_in_doc(
     name = (style_name or "").strip()
     if not name:
         raise ValueError("style_name cannot be empty")
-    if not doc.headers:
+    if not doc.parts.headers:
         raise RuntimeError("document does not contain any headers to host styles")
 
-    header = doc.headers[0]
+    header = doc.parts.headers[0]
     styles_element = document_styles_element(doc)
 
     for style in _iter_unique_styles(doc):
@@ -427,7 +427,7 @@ def create_style_in_doc(
         }
 
     base_style_id = _default_base_style_id(doc)
-    base_style = doc.style(base_style_id)
+    base_style = doc.styles.get(base_style_id)
     if base_style is None:
         raise RuntimeError(f"failed to resolve base style id: {base_style_id}")
 

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/errors.py

@@ -36,6 +36,7 @@ class CommonErrorModel(BaseModel):
 
 
 ERROR_CODE_TO_MCP_CODE: dict[str, int] = {
+    "CLIENT_UPLOAD_PATH_UNAVAILABLE": -32602,
     "DOCUMENT_NOT_FOUND": -32044,
     "PERMISSION_DENIED": -32043,
     "TABLE_INDEX_OUT_OF_RANGE": -32042,
@@ -57,6 +58,7 @@ DEFAULT_ERROR_SUGGESTIONS: dict[str, str] = {
     "AMBIGUOUS_TARGET": "검색 조건을 더 구체화하거나 limit=1로 미리보기를 다시 생성하세요.",
     "BYTE_PATCH_OPEN_SAFETY_FAILED": "반환된 openSafety 진단을 확인하고 일반 저장/복구 경로로 다시 생성하세요.",
     "CAPABILITY_SKEW": "core/automation/plugin ToolSpec 계약 불일치로 쓰기가 차단되었습니다. mcp_server_health의 최소 버전과 contract hash에 맞춰 다시 설치한 뒤 호스트를 재시작하세요.",
+    "CLIENT_UPLOAD_PATH_UNAVAILABLE": "대화에 업로드된 파일의 내부 경로는 로컬 MCP 서버에서 읽을 수 없습니다. 파일을 PC에 저장한 뒤 실제 로컬 경로를 전달하세요.",
     "FIELD_OVERFLOW": "값이 칸에 넘칩니다. fitPolicy(mode=wrap_then_shrink/shrink/truncate_with_report) 또는 overflow=warn으로 다시 채우거나 값을 줄이세요. details.visualComplete.suggestedRetry 참고.",
     "STALE_LINESEG_DETECTED": "오래된 lineseg 레이아웃 캐시가 남았습니다. 해당 문단을 다시 편집해 캐시를 무효화한 뒤 저장하세요.",
     "VISUAL_COMPLETE_FAILED": "한컴 렌더에서 겹침/넘침 등 시각 결함이 감지되었습니다. details.visualComplete를 확인하고 수정 후 다시 저장하세요.",
@@ -120,6 +122,7 @@ def category_for_error(error_code: str) -> ErrorCategory:
     if error_code.startswith("NETWORK_"):
         return "network"
     if error_code in {
+        "CLIENT_UPLOAD_PATH_UNAVAILABLE",
         "INVALID_ARGUMENT",
         "WORKSPACE_PATH_INVALID",
         "DOCUMENT_LOCATOR_REQUIRED",

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/form_fill.py

@@ -311,7 +311,10 @@ def apply_form_fill_workflow(
             if mapping.get("kind") == "form-field":
                 before_fields = _document_form_fields(doc)
                 before_field = _find_form_field_by_mapping(before_fields, mapping)
-                fill_result = doc.fill_form_field(
+                # fields.fill now returns a frozen FieldFillResult rather
+                # than a dict (design §2.3) — read its attributes directly
+                # instead of the old after_value/style_before/... dict keys.
+                fill_result = doc.fields.fill(
                     str(mapping.get("value", "")),
                     field_index=int(mapping["field_index"]),
                 )
@@ -320,10 +323,10 @@ def apply_form_fill_workflow(
                     {
                         **mapping,
                         "before_text": mask_pii(_before_ff, DEFAULT_POLICY) if mask else _before_ff,
-                        "after_text": fill_result["after_value"],
-                        "style_before": fill_result.get("style_before"),
-                        "style_after": fill_result.get("style_after"),
-                        "style_preserved": bool(fill_result.get("style_preserved", False)),
+                        "after_text": fill_result.after,
+                        "style_before": list(fill_result.style_before),
+                        "style_after": list(fill_result.style_after),
+                        "style_preserved": bool(fill_result.style_preserved),
                     }
                 )
             elif mapping.get("kind") == "cell":
@@ -589,7 +592,7 @@ def _build_mapping_analysis(doc: Any, canonical_input: dict[str, Any]) -> dict[s
             if native_mapping is not None:
                 resolved.append(native_mapping)
                 continue
-            matches = doc.find_cell_by_label(label, direction=direction).get("matches", [])
+            matches = doc.tables.find_cell_by_label(label, direction=direction).get("matches", [])
             if len(matches) == 1:
                 match = matches[0]
                 cell = match["target_cell"]
@@ -681,14 +684,50 @@ def _build_mapping_analysis(doc: Any, canonical_input: dict[str, Any]) -> dict[s
     return {"resolved": resolved, "unresolved": unresolved, "formFields": form_field_strategy}
 
 
+def _form_field_to_legacy_dict(field: Any, *, index: int) -> dict[str, Any]:
+    """Rebuild the 5.x form-field dict shape from a 6.0 ``FormField`` view.
+
+    Mirrors ``ops_services.form_fields._form_field_to_legacy_dict`` — kept
+    local (not imported) since this lower-level workflow module sits below
+    the service layer and importing from it would invert that dependency
+    direction. ``index`` is load-bearing here: downstream mapping resolution
+    (``_resolved_explicit_form_field_mapping``/``_find_form_field_by_mapping``)
+    matches on ``field["index"]`` to build ``field_index=`` fill targets.
+    """
+
+    location = field.location
+    return {
+        "index": index,
+        "field_id": field.field_id,
+        "id": field.field_id,
+        "fieldid": field.field_id,
+        "name": field.name,
+        "prompt": field.prompt,
+        "instruction": field.prompt,
+        "memo": field.memo,
+        "dirty": field.element.get("dirty", ""),
+        "is_placeholder": field.is_placeholder,
+        "current_value": field.value,
+        "field_type": field.field_type,
+        "control_type": field.field_type,
+        "section_index": location.section_index,
+        "paragraph_index": location.paragraph_index,
+        "paragraph_index_in_section": location.paragraph_index_in_section,
+        "run_index": location.run_index,
+        "child_index": location.child_index,
+        "has_end": field.has_end,
+        "parameters": [parameter.to_dict() for parameter in field.parameters],
+    }
+
+
 def _document_form_fields(doc: Any) -> list[dict[str, Any]]:
-    list_fields = getattr(doc, "list_form_fields", None)
-    if not callable(list_fields):
-        return []
-    fields = list_fields()
-    if not isinstance(fields, list):
-        return []
-    return [copy.deepcopy(field) for field in fields if isinstance(field, dict)]
+    # fields.all now returns tuple[FormField, ...] rather than list[dict]
+    # (design §2.3/§2.5) — reconstruct the established dict shape since
+    # FormField has no to_dict() of its own.
+    return [
+        _form_field_to_legacy_dict(field, index=index)
+        for index, field in enumerate(doc.fields.all)
+    ]
 
 
 def _normalize_match_text(value: Any) -> str:

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/handlers/content_edit.py

@@ -787,7 +787,10 @@ def insert_picture(
         section_index=section_index,
         align=align,
     )
-    picture_refs = doc.picture_references()
+    # media.picture_references now returns tuple[PictureRef, ...] rather
+    # than list[dict] (design §2.5) — .to_dict() per entry keeps this
+    # handler's own dict-shaped response unchanged.
+    picture_refs = [ref.to_dict() for ref in doc.media.picture_references()]
     result = {
         "ok": True,
         "filename": filename,
@@ -821,19 +824,40 @@ def replace_picture(
     target_path = resolve_path(output) if output else path
     doc = open_doc(path)
     image_data = _decode_image_base64(image_base64)
-    replacement = doc.replace_picture(
+    # media.replace_picture now returns a frozen PictureReplacement (design
+    # §2.4) whose own .to_dict() uses different field names than this op's
+    # established response contract (old_binaryItemIDRef/new_binaryItemIDRef/
+    # removedOldImage/geometryPreserved/picture_index/section_index), which
+    # existing callers/tests depend on — rebuild that exact shape instead.
+    replacement = doc.media.replace_picture(
         image_data,
         image_format,
         picture_index=picture_index,
         binary_item_id_ref=binary_item_id_ref,
         remove_orphaned=remove_orphaned,
     )
+    replaced_section_index = next(
+        (
+            index
+            for index, section in enumerate(doc.sections)
+            if section.element is replacement.picture.paragraph.section.element
+        ),
+        None,
+    )
+    replacement_payload = {
+        "picture_index": picture_index,
+        "section_index": replaced_section_index,
+        "old_binaryItemIDRef": replacement.previous_item_id,
+        "new_binaryItemIDRef": replacement.item_id,
+        "removedOldImage": bool(replacement.removed_orphans),
+        "geometryPreserved": True,
+    }
     result = {
         "ok": True,
         "filename": filename,
         "outputPath": target_path,
-        "replacement": replacement,
-        "pictureReferences": doc.picture_references(),
+        "replacement": replacement_payload,
+        "pictureReferences": [ref.to_dict() for ref in doc.media.picture_references()],
         "idIntegrity": _id_integrity_payload(doc),
     }
     if dry_run:

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/handlers/layout_style.py

@@ -294,7 +294,10 @@ def set_paragraph_format(
     if guard is not None:
         return guard
     doc = open_doc(path)
-    result = doc.set_paragraph_format(
+    # apply_paragraph_format now returns a frozen ParagraphFormatResult
+    # (design §2.4) rather than a dict — .to_dict() keeps this handler's own
+    # dict-shaped response (filename merged below) unchanged.
+    result = doc.styles.apply_paragraph_format(
         paragraph_index=paragraph_index,
         paragraph_indexes=paragraph_indexes,
         alignment=alignment,
@@ -308,7 +311,7 @@ def set_paragraph_format(
         keep_with_next=keep_with_next,
         keep_lines=keep_lines,
         page_break_before=page_break_before,
-    )
+    ).to_dict()
     result["filename"] = filename
     if dry_run:
         return _with_dry_run_verification(result, doc, path)
@@ -342,7 +345,10 @@ def set_page_setup(
     if guard is not None:
         return guard
     doc = open_doc(path)
-    result = doc.set_page_setup(
+    # page.setup now returns a frozen PageSetup (design §2.4) rather than a
+    # dict — .to_dict() keeps this handler's own dict-shaped response
+    # (filename merged below) unchanged.
+    result = doc.page.setup(
         paper_size=paper_size,
         width_mm=width_mm,
         height_mm=height_mm,
@@ -358,7 +364,7 @@ def set_page_setup(
         columns=columns,
         column_gap_mm=column_gap_mm,
         section_index=section_index,
-    )
+    ).to_dict()
     result["filename"] = filename
     if dry_run:
         return _with_dry_run_verification(result, doc, path)
@@ -398,13 +404,26 @@ def set_header_footer(
     if guard is not None:
         return guard
     doc = open_doc(path)
-    wrapper = doc.set_header_footer(
-        kind=kind,
-        text=text,
-        content=content,
-        section_index=section_index,
-        page_type=page_type,
-    )
+    # set_header_footer is demoted in 6.0 with no namespace replacement
+    # (design table row 102, kind= dispatch removed) — dispatch here
+    # instead, replicating the normalization the removed method used to do.
+    normalized_kind = kind.strip().lower() if isinstance(kind, str) else kind
+    if normalized_kind == "header":
+        wrapper = doc.page.set_header(
+            text=text,
+            content=content,
+            section_index=section_index,
+            page_type=page_type,
+        )
+    elif normalized_kind == "footer":
+        wrapper = doc.page.set_footer(
+            text=text,
+            content=content,
+            section_index=section_index,
+            page_type=page_type,
+        )
+    else:
+        raise ValueError("kind must be 'header' or 'footer'")
     result = {
         "filename": filename,
         "headerFooter": _header_footer_payload(wrapper, kind=kind, page_type=page_type),
@@ -435,7 +454,7 @@ def set_page_number(
     if guard is not None:
         return guard
     doc = open_doc(path)
-    wrapper = doc.set_page_number(
+    wrapper = doc.page.set_page_number(
         target=target,
         page_type=page_type,
         format=format,
@@ -478,7 +497,10 @@ def set_list_format(
     if guard is not None:
         return guard
     doc = open_doc(path)
-    result = doc.set_list_format(
+    # apply_list_format now returns a frozen ListFormatResult (design §2.4)
+    # rather than a dict — .to_dict() keeps this handler's own dict-shaped
+    # response (filename merged below) unchanged.
+    result = doc.styles.apply_list_format(
         paragraph_index=paragraph_index,
         paragraph_indexes=paragraph_indexes,
         kind=kind,
@@ -486,7 +508,7 @@ def set_list_format(
         bullet_char=bullet_char,
         number_format=number_format,
         start=start,
-    )
+    ).to_dict()
     result["filename"] = filename
     if dry_run:
         return _with_dry_run_verification(result, doc, path)

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/handlers/tracked_changes.py

@@ -483,30 +483,36 @@ def add_tracked_edit(
             paragraph = doc.paragraphs[paragraph_index]
             before_text = _tracked_paragraph_text(paragraph)
             if edit_type == "insert":
-                change_id = doc.add_tracked_insert(
+                # tracking.insert/delete/replace now return TrackedChange /
+                # TrackedReplacement objects rather than bare int/tuple
+                # (design §2.6) — .change_id (and .delete/.insert for the
+                # replace case, in the same delete-then-insert order 5.x
+                # returned) keeps this handler's own int-list response shape
+                # unchanged.
+                change = doc.tracking.insert(
                     paragraph,
                     edit["text"],
                     author=author,
                     date=normalized_date,
                 )
-                change_ids = [change_id]
+                change_ids = [change.change_id]
             elif edit_type == "delete":
-                change_id = doc.add_tracked_delete(
+                change = doc.tracking.delete(
                     paragraph,
                     match=edit.get("match"),
                     author=author,
                     date=normalized_date,
                 )
-                change_ids = [change_id]
+                change_ids = [change.change_id]
             elif edit_type == "replace":
-                replace_ids = doc.add_tracked_replace(
+                replacement = doc.tracking.replace(
                     paragraph,
                     edit["old"],
                     edit["new"],
                     author=author,
                     date=normalized_date,
                 )
-                change_ids = list(replace_ids)
+                change_ids = [replacement.delete.change_id, replacement.insert.change_id]
             else:  # pragma: no cover - validation prevents this branch
                 raise ValueError(f"unsupported tracked edit type: {edit_type}")
             edit_results.append(

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

@@ -5,23 +5,34 @@
   "releaseState": {
     "status": "release-approved",
     "candidate": {
-      "pythonHwpx": "5.7.0",
+      "pythonHwpx": "6.1.0",
       "canonicalDistribution": "python-hwpx-automation",
-      "canonicalAutomation": "6.7.1",
+      "canonicalAutomation": "7.0.2",
       "compatibilityDistribution": "hwpx-mcp-server",
-      "compatibility": "6.7.1",
-      "plugin": "1.7.0",
-      "contractHash": "98510af22d13899c"
+      "compatibility": "7.0.2",
+      "plugin": "2.0.0",
+      "contractHash": "34a91560759dc47a"
     },
     "currentPublic": {
-      "pythonHwpx": "5.6.0",
+      "pythonHwpx": "6.1.0",
       "primaryDistribution": "python-hwpx-automation",
-      "primaryApplication": "6.6.4",
-      "plugin": "1.6.0",
-      "contractHash": "19898dba41495c47"
+      "primaryApplication": "7.0.1",
+      "plugin": "2.0.0",
+      "contractHash": "34a91560759dc47a"
     },
     "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."
   },
+  "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.",
+    "legacyCompatibilityDistribution": "hwpx-mcp-server",
+    "legacyCompatibilityVersion": "5.1.1",
+    "legacyCoreVersion": "4.2.0",
+    "legacyCoreSpecifiers": [
+      ">=4.2.0",
+      "<5"
+    ],
+    "legacyCoreRequirementCount": 3
+  },
   "identifiers": [
     {
       "surface": "repository",

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/mixed_form.py

@@ -2393,7 +2393,7 @@ def _specialized_allowed_members(source_bytes: bytes) -> set[str]:
         members = {str(section.part_name) for section in document.document.sections}
         members.update(
             str(header.part_name)
-            for header in getattr(document.document, "headers", ())
+            for header in getattr(document.document.parts, "headers", ())
         )
     if not members:
         raise ValueError("specialized form operation has no editable document members")

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/office/agent/blueprint/dump.py

@@ -115,7 +115,7 @@ def _numbering_properties(agent: HwpxAgentDocument, record: NodeRecord) -> dict[
     if record.kind != "paragraph":
         return None
     paragraph = record.native
-    para_pr = agent.document.paragraph_property(paragraph.element.get("paraPrIDRef"))
+    para_pr = agent.document.styles.paragraph_property(paragraph.element.get("paraPrIDRef"))
     heading = para_pr.heading if para_pr is not None else None
     if heading is None or not heading.type or str(heading.type).upper() == "NONE":
         return None
@@ -143,7 +143,7 @@ def _numbering_properties(agent: HwpxAgentDocument, record: NodeRecord) -> dict[
 def _style_dependency(agent: HwpxAgentDocument, record: NodeRecord) -> dict[str, Any] | None:
     if record.kind == "paragraph":
         paragraph = record.native
-        style = agent.document.style(paragraph.element.get("styleIDRef"))
+        style = agent.document.styles.get(paragraph.element.get("styleIDRef"))
         properties = {
             "category": "paragraph",
             "name": record.summary.get("style"),

{python_hwpx_automation-6.7.1 → python_hwpx_automation-7.0.2}/src/hwpx_automation/office/agent/blueprint/mapping.py

@@ -299,8 +299,11 @@ def materialize_dependencies(
             elif family == "resource":
                 asset_path = str(properties["assetPath"])
                 suffix = asset_path.rsplit(".", 1)[-1]
+                # media.add_image now returns a BinaryItem rather than a bare
+                # str (design §2.6) — str(...) is the documented migration
+                # buffer (item_id), keeping this identity payload a plain string.
                 item["identity"] = {
-                    "binaryItemIDRef": document.add_image(assets[asset_path], suffix),
+                    "binaryItemIDRef": str(document.media.add_image(assets[asset_path], suffix)),
                     "mediaType": properties["mediaType"],
                 }
             else:  # pragma: no cover - validated dependency family exhaustiveness