BlackBuddle avatar

hwpx-docs-privacy

Optional add-on of hwpx-docs: the model sees pseudonym tags instead of the personal data that its rules find in Hangul documents; real values stay in a local vault and return when a document is written. A guard against slips, not a boundary

version
0.1.0
GitHub stars
34

Install

/plugin install hwpx-docs-privacy@blackbuddle

Run it inside Claude Code after adding the marketplace with /plugin marketplace add BlackBuddle/hwpx-docs.

Contents

Discovered from source

Skills 1

Privacy layer (the model sees pseudonyms for what the rules find)

Needs the plugin hwpx-docs. hd = its command. pv = python "${CLAUDE_PLUGIN_ROOT}/scripts/pv.py". An hd call prints tags instead of the personal data that its rules find (rule-based: an odd layout can pass), for example ⟪성명1⟫, ⟪주민번호1|1980년대·남⟫, ⟪질환1|정신·행동⟫. The real value stays in a local vault.

  1. Read a document only with hd text|slots|form list|read <file>. Reading the file directly (Read, cat, unzip, Get-Content) is refused by a hook for the usual commands; other ways are not caught, so do not try them. Text files that hd names as output (-o, the spec json) are written already masked; other files that hd writes next to them (the parts of hd read) are closed to Read.
  2. Write with tags. Give a tag where the real value belongs: hd edit in.hwpx out.hwpx --set "성명=⟪성명1⟫", or a spec / values / md file that holds tags. The tag is turned into the real value just before the file is written, and a particle after it is fixed to the real word (⟪성명1⟫은). An unknown tag is an error. Never type a real personal value: a prompt that holds a certain one is blocked.
  3. The same value has the same tag in one vault. For an exact answer ask the vault: pv calc "age(⟪주민번호1⟫, 2026-11-16) >= 19" (also sex, same, count). A result that is not a yes / no becomes a new tag ⟪계산1⟫.
  4. To see layout, hd render / hd preview an HWPX: the picture is drawn from a covered copy. An HWP is converted first (hd hwp tohwpx). A covered copy to keep: pv mask-copy in.hwpx out.hwpx.
  5. Do not guess a masked value. If the task needs the hidden content itself, say so and ask the user to reveal that item on a terminal (pv consent <tag>); you cannot do it yourself.
  6. pv list (tags, never values), pv audit (what was masked, blocked, revealed), pv status. Modes (settings file; HWPX_PRIVACY_MODE=strict raises it): standard (default: identifiers, names, contact, finance, pictures, metadata), strict (also dictionary terms such as diseases and crime names, other ID numbers, birth date, age, school, employer, family names, every typed form value). When a tool call is refused, do not work around it with another tool or command: use hd and pv. Do not put a person's name into a file name.

Sponsors

Details

Marketplace
BlackBuddle/hwpx-docs
Source
addons/hwpx-docs-privacy
Category
Community

More from BlackBuddle/hwpx-docs

All 3