hwpx
hwpx (HWPX / OWPML)
.hwpx는 ZIP 기반 OWPML 문서다. 모든 작업은 hwpx-mcp-server의 MCP 도구를 1차 경로로 사용한다.
MCP가 없을 때의 local Python(python-hwpx >= 3.3.1) 대안과 번들 스크립트는 references 문서에만 있다.
일반적인 읽기·편집·양식 채움·문서 생성처럼 여러 단계를 거치는 작업은 서버가 상태와 안전 정책을
강제하는 start_workflow를 1차 경로로 쓴다. get_workflow·continue_workflow로 진행하고,
decision에서만 approve_workflow_decision을 호출한다. 중단·재개는 cancel_workflow·resume_workflow를
쓴다. 큰 결과의 resultRef는 get_workflow_result로 회수한다. typed 입력과 영수증 계약은
workflows-autonomous를 본다.
primitive 도구는 workflow가 지원하지 않는 전문 작업 또는 진단용 escape hatch다. 단, 처음 보는
기존 문서의 semantic 구조를 탐색하고 본문·표 셀·기존 단순 머리글 story 또는 블록 이동·복사를
포함한 이종 편집을 한 번에 적용하는 요청은
get_document_node → query_document_nodes → apply_document_commands 경로를 쓴다.
지원되는 문서·하위 트리를 다른 HWPX로 이식할 때는 같은 경로로 source/target canonical path를
확정한 뒤 dump_document_blueprint → manifest의 unsupported/fidelity 검토 →
replay_document_blueprint(dry-run → commit)를 쓴다.