v0.1.1

Closes the gap between what the guide documents and what the tooling actually enforces.

Two documented failure modes were described but never checked. tbl@rowCnt disagreeing with the real row count collapses the document onto one page; a stale secCnt after pulling a chapter out of a merged report opens to a single blank page. hwpxlib kept both correct when you went through its helpers, but a document that arrived already wrong passed every check. Both are now gated, and exposed as rowcnt_mismatches() / seccnt_mismatch().

The checks only ran if the agent chose to run them. hwpx_guard.py registers as a PostToolUse hook: after each Bash command it takes the .hwpx files named in it that were just modified, runs the structural checks, and hands any failure back to the agent to fix on the spot. Silent on success, and harness-executed — its model-context cost is zero.

Nothing pinned the helpers' output. corpus/ runs five real edits — row deletion, column widening, a cell edit, two endnotes at one anchor, section extraction — against a document generated in code, and compares the result to committed expectations. Comparison is structural rather than byte-exact, since a re-deflated entry varies with the zlib version and CI runs on a different platform than development.

Fixed

• table_width_ok() raised AttributeError on a table missing its geometry, aborting the whole verify.py run instead of reporting. It now returns "no verdict".
• Both new gates treat an absent attribute as stating nothing rather than as a failure, and the secCnt lookup no longer assumes the hh: prefix.
• The 0.1.0 changelog listed rowCnt and secCnt among its hard checks. They were not checked; corrected in place.

Full detail in CHANGELOG.md.

v0.1.0

First tagged release.

Install

/plugin marketplace add kangdacool/hwpx-editing-skill
/plugin install hwpx-editing@kangdacool

or npx skills add kangdacool/hwpx-editing-skill for Codex, Cursor, Gemini CLI and OpenClaw.

What's in it

• The field guide (hwpx-guide.md), §1 parsing through §7 verification.
• repack_preserve — a no-op repack reproduces the original byte for byte, proven by selftest.py.
• verify.py — the build checklist, CI-gateable, including hard checks for the failures that pass every structural check: an endnote nested inside an endnote, tbl@rowCnt disagreeing with the real row count, a stale secCnt after a section is extracted.
• audit_layout.py — render-based: wrapped cells, blank pages, TOC page numbers that disagree with the caption's real page. Reads any rendered PDF, not only HWPX.
• audit_typography.py — font consistency by name, and JUSTIFY letter-spacing blowout near Latin text.
• remerge_check.py — inserts an extracted chapter into the master in 한글, renders, and reads the numbering back.
• Conversion: tables to Excel, document to Markdown, document to Word, Excel/CSV into an HWPX table.

Full detail in CHANGELOG.md.