hwpx-kit-cli 0.2.1__tar.gz → 0.3.0__tar.gz

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/.claude-plugin/plugin.json

@@ -1,9 +1,9 @@
-{
-  "name": "hwpx-kit",
-  "description": "한글(HWPX/HWP) 문서 자동화 스킬 모음 — 양식 분석·채우기·백지 생성·표기 변환·공문 규약·표 계산·오피스 출력. CLI는 첫 사용 시 스킬이 설치를 안내 (Python 3.10+ 필요).",
-  "version": "0.2.1",
-  "author": {
-    "name": "6aneffy",
-    "email": "tkdgus990809@gmail.com"
-  }
+{
+  "name": "hwpx-kit",
+  "description": "한글(HWPX/HWP) 문서 자동화 스킬 모음 — 양식 분석·채우기·백지 생성·표기 변환·공문 규약·표 계산·오피스 출력. CLI는 첫 사용 시 스킬이 설치를 안내 (Python 3.10+ 필요).",
+  "version": "0.3.0",
+  "author": {
+    "name": "6aneffy",
+    "email": "tkdgus990809@gmail.com"
+  }
 }

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/.gitignore

@@ -13,3 +13,4 @@ private/
 incoming/
 node_modules/
 mcp/
+.playwright-mcp/

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/CLAUDE.md

@@ -26,7 +26,7 @@ skills/*/SKILL.md → Claude Code 플러그인 스킬들 (.claude-plugin/plugin.
  └─ office-export    → hwpx→docx(변환)·pptx/xlsx(재구성, officecli 선택 의존)
 
 CLI (cli.py) — JSON 봉투, 종료코드 0/1/2
- └─ commands/ (analyze·fill·read·validate·convert·export·render·generate·fmt·row-add·row-del·row-height·table-clear·table-set·table-copy·table-map·table-new·page-break·outline)
+ └─ commands/ (analyze·fill·fill-batch·inspect·read·validate·convert·export·render·generate·fmt·row-add·row-del·row-height·table-clear·table-set·table-copy·table-map·table-new·page-break·outline)
      ├─ format.py ← 순수함수 (금액한글화·요일·만나이) — 엔진 임포트 금지, fmt는 파일 인수 없음(FILE_NOT_FOUND 가드 우회)
      └─ adapter/ ← 명령 계층은 어댑터 인터페이스만 사용 (엔진 직접 import 금지)
          ├─ hwpx_engine.py   → python-hwpx (hwpx 분석·채우기·검증·표 조작, 순수 Python)

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hwpx-kit-cli
-Version: 0.2.1
+Version: 0.3.0
 Summary: 한글(HWPX) 문서 자동화 CLI — Korean HWPX document automation for AI agents: analyze, fill, read, validate, table ops
 Project-URL: Homepage, https://github.com/6aneffy/hwpx-kit
 Project-URL: Repository, https://github.com/6aneffy/hwpx-kit
@@ -33,7 +33,7 @@ Description-Content-Type: text/markdown
 [![PyPI](https://img.shields.io/pypi/v/hwpx-kit-cli.svg)](https://pypi.org/project/hwpx-kit-cli/)
 [![Python](https://img.shields.io/badge/python-3.10%2B-3776AB.svg)](https://www.python.org/)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-d97757.svg)](https://claude.com/claude-code)
-[![Tests](https://img.shields.io/badge/tests-160%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-176%20passing-brightgreen.svg)](tests/)
 
 </div>
 
@@ -66,6 +66,30 @@ hwpx-kit은 **AI 에이전트가 한글 문서를 읽고, 채우고, 고치고,
 **이런 분들을 위해 만들었습니다**: 공공기관·학교의 서식 담당자, 사업계획서를 반복 작성하는
 창업자·연구자, 한글 문서를 AI 워크플로에 넣고 싶은 개발자.
 
+## 데모 — 한마디로 기획서 한 부
+
+> "hwpx로 새로운 사업기획서 작성해줘. 서울광역시에서 진행하는 Claude Code 해커톤"
+
+**① 시작점 — 내장 템플릿** (양식 파일이 없을 때 기준. 갖고 있는 양식이 있으면 그 양식을 그대로 씁니다)
+
+![내장 템플릿](docs/images/Before.png)
+
+**② 작업 과정** — 필수 정보(일시·대상·주최·예산)를 먼저 묻고, 답을 받아 진행합니다
+
+![작업 과정](docs/images/Tasking.png)
+
+**③ 결과물** — 표지·5개 장·일정표·예산표까지 채워진 완성본. 서식은 템플릿 그대로
+
+![완성본](docs/images/After.png)
+
+이 데모에서 실제로 일어난 일들:
+
+- **아는 것만 쓰고, 모르는 건 묻습니다** — 장소가 미정이라고 하자 "서울 시내 행사장(추후 확정)"으로 표기하고 확정되면 수정하겠다고 알림. 말하지 않은 정원·시상금을 지어내지 않음
+- **내용을 주면 그대로, 안 주면 Claude가 초안** — 시상금 구성은 사용자가 준 숫자 그대로, 추진배경·목적은 "필요하다고 생각하는 것들 다 써줘"라는 요청에 Claude가 작성. **상세하게 말할수록 상세하게 반영됩니다**
+- **표 계산은 결정론** — 예산표 합계 7,000 + 30,000 = 총계 37,000천원, 수기 계산 착오 없음
+- **구조도 바꿉니다** — 장 추가/복제, 표 행 추가·삭제(서식 승계), 쪽나눔까지. "5장 뒤에 강사진 장 추가해줘"가 통합니다
+- **기존 양식 재활용** — 작성 완료된 옛 기획서를 주고 "○○사업용으로 바꿔줘"라고 하면 그 문서를 양식 삼아 내용만 전면 교체 (서식 무손상)
+
 ## 30초 설치
 
 Claude Code에서:
@@ -120,6 +144,8 @@ hwpx-kit validate 문서.hwpx --json           # 구조 검증
 
 # 채우기·편집 (원본 불변 — 항상 --out 사본)
 hwpx-kit fill 양식.hwpx --data 값.json --out 결과.hwpx
+hwpx-kit fill-batch 양식.hwpx --rows 명단.xlsx --template 값틀.json --out-dir 결과/ --name "{성명}_위촉장.hwpx"  # 메일머지
+hwpx-kit inspect 결과.hwpx --json            # 제출 전 검수 — 잔여 마커·공문 표기·개인정보
 hwpx-kit table-set 문서.hwpx --table 3 --data 셀.json --out 결과.hwpx   # 좌표 셀 쓰기
 hwpx-kit table-clear 문서.hwpx --table 3 --rows 1-20 --out 결과.hwpx    # 셀 내용 비우기
 hwpx-kit table-copy 문서.hwpx --table 1 --after-table 4 --out 결과.hwpx # 표 통째 복제 (서식·병합 유지)
@@ -164,7 +190,7 @@ hwpx-kit render 문서.hwpx --out p.svg        # SVG 미리보기 (kordoc)
 ## 아키텍처
 
 ```
-Claude Code 스킬 6종 ──→  hwpx-kit CLI (21 명령, JSON 봉투)
+Claude Code 스킬 6종 ──→  hwpx-kit CLI (23 명령, JSON 봉투)
                               └─ adapter/  ← 엔진 격리 계층
                                   ├─ python-hwpx    hwpx 분석·채우기·표 조작
                                   ├─ pypdf·python-docx·openpyxl   타 포맷 읽기
@@ -180,7 +206,7 @@ templates/ 기본 계획서 템플릿 (표지·장 헤더·표 골격, 마커
 
 ## 검증
 
-- 자동 테스트 160개 (pytest)
+- 자동 테스트 176개 (pytest)
 - 실서식 수렴 테스트: 보도자료·신청서·계획서·회의록·공고문 5계열,
   실제 공공기관 문서 30여 종으로 analyze→fill→validate 왕복
 - 실사용 시나리오 테스트 3회 (백지 생성 12분 완주, 장·표 동적 추가, 보도자료 변환)

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/README.md

@@ -10,7 +10,7 @@
 [![PyPI](https://img.shields.io/pypi/v/hwpx-kit-cli.svg)](https://pypi.org/project/hwpx-kit-cli/)
 [![Python](https://img.shields.io/badge/python-3.10%2B-3776AB.svg)](https://www.python.org/)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-d97757.svg)](https://claude.com/claude-code)
-[![Tests](https://img.shields.io/badge/tests-160%20passing-brightgreen.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-176%20passing-brightgreen.svg)](tests/)
 
 </div>
 
@@ -43,6 +43,30 @@ hwpx-kit은 **AI 에이전트가 한글 문서를 읽고, 채우고, 고치고,
 **이런 분들을 위해 만들었습니다**: 공공기관·학교의 서식 담당자, 사업계획서를 반복 작성하는
 창업자·연구자, 한글 문서를 AI 워크플로에 넣고 싶은 개발자.
 
+## 데모 — 한마디로 기획서 한 부
+
+> "hwpx로 새로운 사업기획서 작성해줘. 서울광역시에서 진행하는 Claude Code 해커톤"
+
+**① 시작점 — 내장 템플릿** (양식 파일이 없을 때 기준. 갖고 있는 양식이 있으면 그 양식을 그대로 씁니다)
+
+![내장 템플릿](docs/images/Before.png)
+
+**② 작업 과정** — 필수 정보(일시·대상·주최·예산)를 먼저 묻고, 답을 받아 진행합니다
+
+![작업 과정](docs/images/Tasking.png)
+
+**③ 결과물** — 표지·5개 장·일정표·예산표까지 채워진 완성본. 서식은 템플릿 그대로
+
+![완성본](docs/images/After.png)
+
+이 데모에서 실제로 일어난 일들:
+
+- **아는 것만 쓰고, 모르는 건 묻습니다** — 장소가 미정이라고 하자 "서울 시내 행사장(추후 확정)"으로 표기하고 확정되면 수정하겠다고 알림. 말하지 않은 정원·시상금을 지어내지 않음
+- **내용을 주면 그대로, 안 주면 Claude가 초안** — 시상금 구성은 사용자가 준 숫자 그대로, 추진배경·목적은 "필요하다고 생각하는 것들 다 써줘"라는 요청에 Claude가 작성. **상세하게 말할수록 상세하게 반영됩니다**
+- **표 계산은 결정론** — 예산표 합계 7,000 + 30,000 = 총계 37,000천원, 수기 계산 착오 없음
+- **구조도 바꿉니다** — 장 추가/복제, 표 행 추가·삭제(서식 승계), 쪽나눔까지. "5장 뒤에 강사진 장 추가해줘"가 통합니다
+- **기존 양식 재활용** — 작성 완료된 옛 기획서를 주고 "○○사업용으로 바꿔줘"라고 하면 그 문서를 양식 삼아 내용만 전면 교체 (서식 무손상)
+
 ## 30초 설치
 
 Claude Code에서:
@@ -97,6 +121,8 @@ hwpx-kit validate 문서.hwpx --json           # 구조 검증
 
 # 채우기·편집 (원본 불변 — 항상 --out 사본)
 hwpx-kit fill 양식.hwpx --data 값.json --out 결과.hwpx
+hwpx-kit fill-batch 양식.hwpx --rows 명단.xlsx --template 값틀.json --out-dir 결과/ --name "{성명}_위촉장.hwpx"  # 메일머지
+hwpx-kit inspect 결과.hwpx --json            # 제출 전 검수 — 잔여 마커·공문 표기·개인정보
 hwpx-kit table-set 문서.hwpx --table 3 --data 셀.json --out 결과.hwpx   # 좌표 셀 쓰기
 hwpx-kit table-clear 문서.hwpx --table 3 --rows 1-20 --out 결과.hwpx    # 셀 내용 비우기
 hwpx-kit table-copy 문서.hwpx --table 1 --after-table 4 --out 결과.hwpx # 표 통째 복제 (서식·병합 유지)
@@ -141,7 +167,7 @@ hwpx-kit render 문서.hwpx --out p.svg        # SVG 미리보기 (kordoc)
 ## 아키텍처
 
 ```
-Claude Code 스킬 6종 ──→  hwpx-kit CLI (21 명령, JSON 봉투)
+Claude Code 스킬 6종 ──→  hwpx-kit CLI (23 명령, JSON 봉투)
                               └─ adapter/  ← 엔진 격리 계층
                                   ├─ python-hwpx    hwpx 분석·채우기·표 조작
                                   ├─ pypdf·python-docx·openpyxl   타 포맷 읽기
@@ -157,7 +183,7 @@ templates/ 기본 계획서 템플릿 (표지·장 헤더·표 골격, 마커
 
 ## 검증
 
-- 자동 테스트 160개 (pytest)
+- 자동 테스트 176개 (pytest)
 - 실서식 수렴 테스트: 보도자료·신청서·계획서·회의록·공고문 5계열,
   실제 공공기관 문서 30여 종으로 analyze→fill→validate 왕복
 - 실사용 시나리오 테스트 3회 (백지 생성 12분 완주, 장·표 동적 추가, 보도자료 변환)

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/commands/hwpx.md

@@ -1,8 +1,11 @@
 ---
-description: hwpx-kit 도움말 — 스킬 6종과 사용 예시 안내
+description: hwpx-kit 도움말 — 스킬 6종과 사용 예시 안내 (사용자가 /hwpx를 직접 입력했을 때 전용)
+disable-model-invocation: true
 ---
 
 아래 카탈로그를 그대로 사용자에게 출력하라. 다른 도구를 호출하지 말 것.
+(이 카탈로그는 사용자가 /hwpx를 직접 쳤을 때만 보여주는 것 — 문서 작업
+요청이 들어온 상황이라면 카탈로그 출력 없이 해당 스킬로 바로 진행하라.)
 
 ```
 📄 hwpx-kit — 한글(HWPX) 문서 자동화

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/pyproject.toml

@@ -1,44 +1,44 @@
-[project]
-name = "hwpx-kit-cli"
-version = "0.2.1"
-description = "한글(HWPX) 문서 자동화 CLI — Korean HWPX document automation for AI agents: analyze, fill, read, validate, table ops"
-readme = "README.md"
-requires-python = ">=3.10"
-license = "Apache-2.0"
-authors = [{ name = "6aneffy", email = "tkdgus990809@gmail.com" }]
-keywords = ["hwpx", "hwp", "hangul", "korean", "document-automation", "claude-code"]
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "Operating System :: OS Independent",
-    "Topic :: Office/Business :: Office Suites",
-]
-dependencies = [
-    "openpyxl>=3.1.5",
-    "pypdf>=6.14.2",
-    "python-docx>=1.2.0",
-    "python-hwpx>=2.24,<3",
-]
-
-[project.optional-dependencies]
-convert = ["pyhwpx; sys_platform == 'win32'"]
-
-[project.urls]
-Homepage = "https://github.com/6aneffy/hwpx-kit"
-Repository = "https://github.com/6aneffy/hwpx-kit"
-Issues = "https://github.com/6aneffy/hwpx-kit/issues"
-
-[project.scripts]
-hwpx-kit = "hwpx_kit.cli:main"
-
-[dependency-groups]
-dev = ["pytest>=8"]
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/hwpx_kit"]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
+[project]
+name = "hwpx-kit-cli"
+version = "0.3.0"
+description = "한글(HWPX) 문서 자동화 CLI — Korean HWPX document automation for AI agents: analyze, fill, read, validate, table ops"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "Apache-2.0"
+authors = [{ name = "6aneffy", email = "tkdgus990809@gmail.com" }]
+keywords = ["hwpx", "hwp", "hangul", "korean", "document-automation", "claude-code"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Office/Business :: Office Suites",
+]
+dependencies = [
+    "openpyxl>=3.1.5",
+    "pypdf>=6.14.2",
+    "python-docx>=1.2.0",
+    "python-hwpx>=2.24,<3",
+]
+
+[project.optional-dependencies]
+convert = ["pyhwpx; sys_platform == 'win32'"]
+
+[project.urls]
+Homepage = "https://github.com/6aneffy/hwpx-kit"
+Repository = "https://github.com/6aneffy/hwpx-kit"
+Issues = "https://github.com/6aneffy/hwpx-kit/issues"
+
+[project.scripts]
+hwpx-kit = "hwpx_kit.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hwpx_kit"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/skills/gongmun-format/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gongmun-format
-description: 행안부 공문서 작성 규약 — 글머리 위계(□○-※*), 날짜·금액 표기, 홑낫표, 어절정리, 복붙 깨짐 복구. 공문·보도자료·계획안 초안 작성이나 "공문 형식으로", "공문서 규정대로", "보고서 양식 맞춰줘" 요청 시 사용. Triggers: Korean government document style, gongmun formatting.
+description: 행안부 공문서 작성 규약 — 글머리 위계(□○-※*), 날짜·금액 표기, 홑낫표, 어절정리, 복붙 깨짐 복구, 제출 전 기계 검수(inspect). 공문·보도자료·계획안 초안 작성이나 "공문 형식으로", "공문서 규정대로", "보고서 양식 맞춰줘", "제출 전에 검토해줘" 요청 시 사용. Triggers: Korean government document style, gongmun formatting, review before submission.
 ---
 
 # gongmun-format: 행안부 공문 작성 규약
@@ -34,6 +34,17 @@ description: 행안부 공문서 작성 규약 — 글머리 위계(□○-※*)
 - **법령·문서명**: 홑낫표 `「」` 로 감싼다 — `「행정 효율과 협업 촉진에 관한 규정」`
 - **증감·비율**: table-calc 스킬의 표기 관습(△·%p 등) 따름
 
+## 제출 전 검수 — "검토해줘" (기계 검사 먼저, 판단은 그 위에)
+
+`hwpx-kit inspect <문서.hwpx> --json` — 결정론 검사 3종 (fmt와 같은 "암산 금지" 원칙):
+- **residue**: 채우다 만 {{마커}}·○○○ 자리표시·"(예시)" 안내문 잔존
+- **gongmun**: 날짜 하이픈 표기(2026-07-10 → `2026. 7. 10.`), 오전/오후 시각(→ 24시각제)
+- **pii**: 주민번호·휴대전화·이메일 잔존 (공개 배포 문서면 특히)
+
+종료코드 2 = 위반 있음. `issues[]`의 code·context를 **사람 말로 요약**해 보여주고,
+수정할 항목을 확정받아 fill(text:/delete:)로 고친 뒤 재검사. 기계 검사가 못 보는
+것(위계 건너뜀, 어색한 문장, 내용 누락)은 read 출력을 직접 읽고 이 스킬 규약으로 판단.
+
 ## 텍스트 정리 (재작성 계열 — 우리가 범피스보다 잘하는 것)
 
 한글 문서에서 read로 뽑은 텍스트나 사용자가 붙여넣은 텍스트가 깨져 있으면:

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/skills/hwpx-form/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hwpx-kit
-description: HWPX 양식 자동화 — 한글(HWPX/HWP) 양식 분석, 내용 채우기, 본문 추출, 구조 검증, .hwp→.hwpx 변환. 사용자가 hwpx/hwp 파일을 주며 "이 양식에 채워줘", "여기에 써줘", "이 문서 읽어줘/요약해줘", "hwp 변환해줘" 할 때 사용. Triggers: fill this Korean form, read this hwp/hwpx file, Hangul document automation.
+description: HWPX 양식 자동화 — 한글(HWPX/HWP) 양식 분석, 내용 채우기, 본문 추출, 구조 검증, .hwp→.hwpx 변환. 사용자가 hwpx/hwp 파일을 주며 "이 양식에 채워줘", "여기에 써줘", "이 명단으로 30명분 만들어줘"(일괄 생성), "이 엑셀 표 넣어줘", "이 문서 읽어줘/요약해줘", "hwp 변환해줘" 할 때 사용. Triggers: fill this Korean form, mail merge certificates, read this hwp/hwpx file, Hangul document automation.
 ---
 
 # hwpx-kit: HWPX 양식 자동화
@@ -21,6 +21,11 @@ CLI `hwpx-kit`으로 hwpx 문서를 다룬다. 항상 `--json`을 붙여 실행
    (실패 시 폴백: `pip install --user git+https://github.com/6aneffy/hwpx-kit.git`)
    → `python -m hwpx_kit.cli --version` 확인 후 원래 작업 계속
 
+**구버전 업그레이드도 같은 이름**: 설치돼 있는데 필요한 명령(row-add 등)이
+없으면 `pip install -U hwpx-kit-cli`. 🔴 **PyPI 배포명은 `hwpx-kit-cli`다**
+— `hwpx-kit`은 PyPI에 없는 이름이니 (플러그인·명령어 이름일 뿐) 그걸로
+검색/설치 시도하지 말 것
+
 기존 문서(계획안·보고서 작성본)를 양식 삼아 **다른 사업 문서를 새로 쓰는** 요청도
 같은 흐름이다 — 내용(사업명·배경·커리큘럼 등)은 네가 초안을 짜서 사용자와 확정하고,
 문서화는 read → text:/table: 교체로 한다. 서식은 원본 그대로 유지된다.
@@ -129,9 +134,40 @@ CLI `hwpx-kit`으로 hwpx 문서를 다룬다. 항상 `--json`을 붙여 실행
    `hwpx-kit fill <양식.hwpx> --data <값.json> --out <결과.hwpx> --json`
    - 원본은 절대 수정되지 않는다. `--out`은 원본과 다른 경로여야 한다
    - 종료 코드 2면 `data.unmatched[]`의 사유를 사용자에게 보여주고 값이나 키를 수정해 재시도
-4. **검증**: `hwpx-kit validate <결과.hwpx> --json` — `valid: true` 확인
+4. **검증**: `hwpx-kit validate <결과.hwpx> --json` (구조) →
+   `hwpx-kit inspect <결과.hwpx> --json` (내용 — 잔여 {{마커}}·○○○ 자리표시·
+   공문 표기 위반·개인정보 잔존을 기계 검사. 종료코드 2면 issues[]를 사람 말로
+   요약해 보여주고 수정 여부 확인)
 5. **안내**: 결과 파일 경로를 알려주고, 최종 서식은 한글(한컴오피스)에서 열어 확인하도록 권한다
 
+## 일괄 생성 (메일머지) — "이 명단으로 30명분 만들어줘"
+
+위촉장·수료증·통지서처럼 **같은 양식 × 명단 N명**은 fill을 N번 돌리지 말고
+`fill-batch` 하나로:
+
+1. 명단 파일 확보 — xlsx(1행이 헤더)·csv·json 배열 모두 됨. 명단이 대화로만
+   왔으면 json으로 저장
+2. analyze로 fill_key 파악 → **템플릿 JSON** 작성: 값 속에 `{열이름}` 자리표시
+   ```json
+   {"marker:성명": "{성명}", "marker:과정명": "{과정} 과정"}
+   ```
+3. **첫 1부를 먼저 뽑아 사용자 승인** (fill로 1건) — 승인 후 전체:
+   `hwpx-kit fill-batch <양식.hwpx> --rows <명단.xlsx> --template <템플릿.json> --out-dir <폴더> --name "{성명}_위촉장.hwpx" --json`
+4. 종료코드 2면 `rows[]`에서 실패 행만 추려 보고. 파일명 충돌은 자동 `_2` 접미,
+   금지문자는 `_` 치환. 원본 불변은 fill과 동일
+5. 개인정보 든 명단 파일은 사용자 문서와 동일한 기밀 취급 — 커밋·업로드 금지
+
+## 엑셀 표를 한글 문서에 넣기 — "이 엑셀 표 문서에 넣어줘"
+
+복붙(서식 깨짐) 대신 도구 조합으로:
+1. `hwpx-kit read <파일.xlsx> --format md` — 표 데이터 확보
+2. `outline`으로 삽입 위치(앵커 문단/표) 확인, 애매하면 사용자에게
+3. `table-new --rows R --cols C --like-table <이웃 표> --after-text "<앵커>"` —
+   문서 기존 표 서식을 차용해 새 표 생성 (이웃 표 없으면 --like-table 생략)
+4. `table-set --data <셀.json>`으로 값 기입 — 숫자는 세 자리 콤마 등 표기는
+   table-calc 스킬 관습, 헤더 행은 (0,c) 좌표
+5. validate → 경로 안내
+
 ## 예시 텍스트 교체 (보도자료 등 "예시 문구가 든 양식")
 
 누름틀/빈칸이 아니라 예시 문장이 채워진 양식(보도자료 제목·본문 등)은 `text:` 키 사용:

{hwpx_kit_cli-0.2.1 → hwpx_kit_cli-0.3.0}/src/hwpx_kit/cli.py

@@ -91,6 +91,19 @@ def _build_parser() -> argparse.ArgumentParser:
     ph.add_argument("--out", required=True, help="출력 hwpx 경로 (원본 불변)")
     ph.add_argument("--json", action="store_true")
 
+    pfb = sub.add_parser("fill-batch", help="명단 × 양식 일괄 생성 (메일머지) — 위촉장·수료증·통지서 N부")
+    pfb.add_argument("file", help="양식 hwpx")
+    pfb.add_argument("--rows", required=True, help="명단 파일 (xlsx: 1행 헤더 / csv / json 객체 배열)")
+    pfb.add_argument("--template", required=True, help="fill 데이터 JSON — 값 속 {열이름}이 행마다 치환됨")
+    pfb.add_argument("--out-dir", required=True, help="출력 폴더 (없으면 생성)")
+    pfb.add_argument("--name", required=True, help='파일명 패턴, 예: "{성명}_위촉장.hwpx" (충돌 시 _2 접미)')
+    pfb.add_argument("--json", action="store_true")
+
+    pin = sub.add_parser("inspect", help="제출 전 기계 검수 — 잔여물({{마커}}·○○○)·공문 표기(날짜·시각)·개인정보. 위반 시 종료코드 2")
+    pin.add_argument("file")
+    pin.add_argument("--checks", help="쉼표 구분: residue,gongmun,pii (생략 시 전부)")
+    pin.add_argument("--json", action="store_true")
+
     pra = sub.add_parser("row-add", help="표 행 추가 — 기준 행 서식·높이 승계, 내용은 비움 (세로 병합 걸리면 거부)")
     pra.add_argument("file")
     pra.add_argument("--table", type=int, required=True, help="표 인덱스 (0-기준)")
@@ -214,6 +227,24 @@ def main(argv: list[str] | None = None) -> int:
                 args.file, table=args.table, like=args.like,
                 rows=parse_rows_spec(args.rows), out_path=args.out,
             )
+        elif args.command == "fill-batch":
+            from hwpx_kit.commands.fill_batch import run_fill_batch
+
+            data = run_fill_batch(
+                args.file, rows_path=args.rows, template_path=args.template,
+                out_dir=args.out_dir, name_pattern=args.name,
+            )
+            if not data["all_ok"]:
+                exit_code = 2
+        elif args.command == "inspect":
+            from hwpx_kit.commands.inspect_doc import run_inspect
+
+            data = run_inspect(
+                args.file,
+                checks=[c.strip() for c in args.checks.split(",")] if args.checks else None,
+            )
+            if not data["clean"]:
+                exit_code = 2
         elif args.command == "row-add":
             from hwpx_kit.commands.table_rows import run_row_add
 

hwpx_kit_cli-0.3.0/src/hwpx_kit/commands/fill_batch.py

@@ -0,0 +1,103 @@
+"""fill-batch 명령 — 명단 × 양식 메일머지.
+
+명단(xlsx/csv/json)의 행마다 fill 템플릿의 {열이름}을 치환해 run_fill을
+반복하고, 파일명 패턴으로 사본 N부를 만든다. 원본 불변은 fill과 동일.
+"""
+from __future__ import annotations
+
+import csv
+import json
+import os
+import re
+
+from hwpx_kit.commands.fill import run_fill
+
+_FORBIDDEN_FILENAME = re.compile(r'[\\/:*?"<>|]')
+
+
+def load_rows(rows_path: str) -> list[dict[str, str]]:
+    """명단 파일 → 행 dict 목록. xlsx는 1행을 헤더로 본다."""
+    ext = os.path.splitext(rows_path)[1].lower()
+    if ext == ".json":
+        with open(rows_path, encoding="utf-8") as f:
+            data = json.load(f)
+        if not isinstance(data, list):
+            raise ValueError("명단 JSON은 객체 배열이어야 합니다: [{\"성명\": ...}, ...]")
+        return [{str(k): "" if v is None else str(v) for k, v in row.items()} for row in data]
+    if ext == ".csv":
+        with open(rows_path, encoding="utf-8-sig", newline="") as f:
+            return [dict(row) for row in csv.DictReader(f)]
+    if ext == ".xlsx":
+        import openpyxl
+
+        ws = openpyxl.load_workbook(rows_path, data_only=True).active
+        rows_iter = ws.iter_rows(values_only=True)
+        header = [str(h) if h is not None else "" for h in next(rows_iter, [])]
+        rows = []
+        for values in rows_iter:
+            if values is None or all(v is None for v in values):
+                continue
+            rows.append({
+                header[i]: "" if v is None else str(v)
+                for i, v in enumerate(values) if i < len(header) and header[i]
+            })
+        return rows
+    raise ValueError(f"지원하지 않는 명단 형식: {ext} (xlsx/csv/json)")
+
+
+def _substitute(template: str, row: dict[str, str]) -> str:
+    out = template
+    for key, value in row.items():
+        out = out.replace("{" + key + "}", value)
+    return out
+
+
+def _unique_path(out_dir: str, name: str) -> str:
+    base, ext = os.path.splitext(name)
+    candidate = os.path.join(out_dir, name)
+    n = 2
+    while os.path.exists(candidate):
+        candidate = os.path.join(out_dir, f"{base}_{n}{ext}")
+        n += 1
+    return candidate
+
+
+def run_fill_batch(path: str, rows_path: str, template_path: str,
+                   out_dir: str, name_pattern: str) -> dict:
+    with open(template_path, encoding="utf-8") as f:
+        template: dict[str, str] = json.load(f)
+
+    rows = load_rows(rows_path)
+    if not rows:
+        raise ValueError("명단이 비어 있습니다.")
+    os.makedirs(out_dir, exist_ok=True)
+
+    results = []
+    succeeded = 0
+    for i, row in enumerate(rows):
+        data = {k: _substitute(str(v), row) for k, v in template.items()}
+        name = _FORBIDDEN_FILENAME.sub("_", _substitute(name_pattern, row))
+        out_path = _unique_path(out_dir, name)
+        try:
+            fill_result = run_fill(path, data, out_path)
+            ok = not fill_result["unmatched"]
+            if ok:
+                succeeded += 1
+            results.append({
+                "row": i, "out": fill_result["out"], "ok": ok,
+                "applied": fill_result["applied"],
+                "unmatched": fill_result["unmatched"],
+            })
+        except Exception as exc:
+            results.append({"row": i, "out": None, "ok": False,
+                            "applied": [], "unmatched": [],
+                            "error": str(exc)})
+
+    return {
+        "file": path,
+        "out_dir": os.path.abspath(out_dir),
+        "total": len(rows),
+        "succeeded": succeeded,
+        "all_ok": succeeded == len(rows),
+        "rows": results,
+    }

hwpx_kit_cli-0.3.0/src/hwpx_kit/commands/inspect_doc.py

@@ -0,0 +1,30 @@
+"""inspect 명령 — 제출 전 기계 검수.
+
+문서 본문(표 셀 포함)을 뽑아 inspect_rules의 순수 검사를 돌린다.
+위반이 있으면 CLI가 exit 2 (부분 성공)로 알린다 — 게이트로 쓸 수 있게.
+"""
+from __future__ import annotations
+
+from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+from hwpx_kit.inspect_rules import CHECKS
+
+
+def run_inspect(path: str, checks: list[str] | None = None) -> dict:
+    selected = checks or list(CHECKS)
+    bad = [c for c in selected if c not in CHECKS]
+    if bad:
+        raise ValueError(f"알 수 없는 검사: {bad} (가능: {', '.join(CHECKS)})")
+
+    ad = HwpxEngineAdapter.open(path)
+    text = ad.export_text()
+
+    issues: list[dict] = []
+    for name in selected:
+        issues.extend(CHECKS[name](text))
+
+    return {
+        "file": path,
+        "checks": selected,
+        "issues": issues,
+        "clean": not issues,
+    }

hwpx_kit_cli-0.3.0/src/hwpx_kit/inspect_rules.py

@@ -0,0 +1,84 @@
+"""inspect 순수 검사함수 — 잔여물·공문 표기·PII 정규식.
+
+format.py와 같은 원칙: 엔진 임포트 금지, LLM 판단이 아닌 결정론 검사.
+각 함수는 텍스트 한 덩이를 받아 issues 목록을 반환한다:
+  {"check": ..., "code": ..., "message": ..., "context": <위반 주변 원문>}
+"""
+from __future__ import annotations
+
+import re
+
+_CONTEXT_SPAN = 30
+
+
+def _issue(check: str, code: str, message: str, text: str, match: re.Match) -> dict:
+    start = max(0, match.start() - _CONTEXT_SPAN)
+    end = min(len(text), match.end() + _CONTEXT_SPAN)
+    return {"check": check, "code": code, "message": message,
+            "context": text[start:end].strip()}
+
+
+# ── residue: 채움 잔여물 ──────────────────────────────────────
+
+_RESIDUE_PATTERNS: list[tuple[str, str, re.Pattern]] = [
+    ("leftover_marker", "채우지 않은 {{마커}}가 남아 있음",
+     re.compile(r"\{\{[^{}]{1,40}\}\}")),
+    ("placeholder_chars", "자리표시 문자(○○○·△△△·×××)가 남아 있음",
+     re.compile(r"[○◯]{3,}|[△▲]{3,}|[×✕]{3,}")),
+    ("example_note", "양식 안내문(예시·해당시)이 남아 있음",
+     re.compile(r"\(예시[^)]{0,20}\)|←\s*해당\s*시")),
+]
+
+
+def check_residue_text(text: str) -> list[dict]:
+    issues = []
+    for code, message, pattern in _RESIDUE_PATTERNS:
+        for m in pattern.finditer(text):
+            issues.append(_issue("residue", code, message, text, m))
+    return issues
+
+
+# ── gongmun: 공문 표기 규약 ───────────────────────────────────
+
+# 날짜: 공문은 '2026. 7. 10.' — 하이픈/슬래시 연월일은 위반
+_DATE_BAD = re.compile(r"\b(19|20)\d{2}\s*[-/]\s*\d{1,2}\s*[-/]\s*\d{1,2}\b")
+# 시각: 공문은 24시각제 '15:00' — '오전/오후 N시(N분)'는 위반
+_TIME_BAD = re.compile(r"(오전|오후)\s*\d{1,2}\s*시(\s*\d{1,2}\s*분)?")
+
+
+def check_gongmun_text(text: str) -> list[dict]:
+    issues = []
+    for m in _DATE_BAD.finditer(text):
+        issues.append(_issue("gongmun", "date_style",
+                             "공문 날짜 표기는 '2026. 7. 10.' 형식 — 하이픈/슬래시 표기 위반",
+                             text, m))
+    for m in _TIME_BAD.finditer(text):
+        issues.append(_issue("gongmun", "time_style",
+                             "공문 시각은 24시각제 '15:00' — 오전/오후 표기 위반",
+                             text, m))
+    return issues
+
+
+# ── pii: 개인정보 잔존 ────────────────────────────────────────
+
+_RRN = re.compile(r"\b\d{6}\s*-\s*[1-4]\d{6}\b")           # 주민등록번호
+_PHONE = re.compile(r"\b01[016789]\s*-\s*\d{3,4}\s*-\s*\d{4}\b")  # 휴대전화
+_EMAIL = re.compile(r"\b[\w.+-]+@[\w-]+\.[\w.]{2,}\b")
+
+
+def check_pii_text(text: str) -> list[dict]:
+    issues = []
+    for m in _RRN.finditer(text):
+        issues.append(_issue("pii", "rrn", "주민등록번호 패턴 발견 — 제출 전 확인", text, m))
+    for m in _PHONE.finditer(text):
+        issues.append(_issue("pii", "phone", "휴대전화 번호 발견 — 공개 배포 시 확인", text, m))
+    for m in _EMAIL.finditer(text):
+        issues.append(_issue("pii", "email", "이메일 주소 발견 — 공개 배포 시 확인", text, m))
+    return issues
+
+
+CHECKS = {
+    "residue": check_residue_text,
+    "gongmun": check_gongmun_text,
+    "pii": check_pii_text,
+}

hwpx_kit_cli-0.3.0/tests/test_fill_batch.py

@@ -0,0 +1,153 @@
+"""fill-batch — 명단(xlsx/csv/json) × 양식 → N부 일괄 생성 (메일머지).
+
+한 양식에 fill을 행마다 반복하고 파일명 패턴으로 사본을 만든다.
+원본 불변·행별 실패 보고·파일명 충돌 처리가 계약.
+"""
+import csv
+import json
+
+import pytest
+
+from hwpx_kit.cli import main
+from hwpx_kit.commands.fill_batch import run_fill_batch
+
+
+@pytest.fixture()
+def cert_form(tmp_path):
+    """{{성명}}/{{과정명}} 마커가 든 위촉장 양식."""
+    from hwpx.document import HwpxDocument
+
+    from hwpx_kit.output import quiet_engine
+
+    with quiet_engine():
+        doc = HwpxDocument.new()
+        doc.add_paragraph("위 촉 장")
+        doc.add_paragraph("성명: {{성명}}")
+        doc.add_paragraph("과정: {{과정명}}")
+        path = str(tmp_path / "form.hwpx")
+        doc.save_to_path(path)
+    return path
+
+
+@pytest.fixture()
+def roster_json(tmp_path):
+    rows = [
+        {"성명": "김철수", "과정명": "AI 기초"},
+        {"성명": "이영희", "과정명": "AI 심화"},
+        {"성명": "박민수", "과정명": "AI 기초"},
+    ]
+    p = tmp_path / "roster.json"
+    p.write_text(json.dumps(rows, ensure_ascii=False), encoding="utf-8")
+    return str(p)
+
+
+@pytest.fixture()
+def template_json(tmp_path):
+    p = tmp_path / "template.json"
+    p.write_text(json.dumps({
+        "marker:성명": "{성명}",
+        "marker:과정명": "{과정명} 과정",
+    }, ensure_ascii=False), encoding="utf-8")
+    return str(p)
+
+
+def _read_text(path):
+    from hwpx_kit.adapter.hwpx_engine import HwpxEngineAdapter
+
+    return HwpxEngineAdapter.open(path).export_text()
+
+
+def test_batch_json_roster(cert_form, roster_json, template_json, tmp_path):
+    out_dir = str(tmp_path / "out")
+    result = run_fill_batch(
+        cert_form, rows_path=roster_json, template_path=template_json,
+        out_dir=out_dir, name_pattern="{성명}_위촉장.hwpx",
+    )
+    assert result["total"] == 3 and result["succeeded"] == 3
+    files = [r["out"] for r in result["rows"]]
+    assert any("김철수_위촉장" in f for f in files)
+    text = _read_text(files[0])
+    assert "김철수" in text and "AI 기초 과정" in text
+    # 원본 불변 — 양식엔 마커 그대로
+    assert "{{성명}}" in _read_text(cert_form)
+
+
+def test_batch_xlsx_roster(cert_form, template_json, tmp_path):
+    import openpyxl
+
+    wb = openpyxl.Workbook()
+    ws = wb.active
+    ws.append(["성명", "과정명"])
+    ws.append(["김철수", "AI 기초"])
+    ws.append(["이영희", "AI 심화"])
+    xlsx = str(tmp_path / "roster.xlsx")
+    wb.save(xlsx)
+
+    result = run_fill_batch(
+        cert_form, rows_path=xlsx, template_path=template_json,
+        out_dir=str(tmp_path / "out"), name_pattern="{성명}.hwpx",
+    )
+    assert result["succeeded"] == 2
+    assert "이영희" in _read_text(result["rows"][1]["out"])
+
+
+def test_batch_csv_roster(cert_form, template_json, tmp_path):
+    p = tmp_path / "roster.csv"
+    with open(p, "w", newline="", encoding="utf-8-sig") as f:
+        w = csv.writer(f)
+        w.writerow(["성명", "과정명"])
+        w.writerow(["김철수", "AI 기초"])
+    result = run_fill_batch(
+        cert_form, rows_path=str(p), template_path=template_json,
+        out_dir=str(tmp_path / "out"), name_pattern="{성명}.hwpx",
+    )
+    assert result["succeeded"] == 1
+
+
+def test_batch_name_collision_suffix(cert_form, template_json, tmp_path):
+    rows = [{"성명": "김철수", "과정명": "A"}, {"성명": "김철수", "과정명": "B"}]
+    p = tmp_path / "r.json"
+    p.write_text(json.dumps(rows, ensure_ascii=False), encoding="utf-8")
+    result = run_fill_batch(
+        cert_form, rows_path=str(p), template_path=template_json,
+        out_dir=str(tmp_path / "out"), name_pattern="{성명}.hwpx",
+    )
+    outs = [r["out"] for r in result["rows"]]
+    assert len(set(outs)) == 2  # 충돌해도 덮어쓰지 않고 접미사
+
+def test_batch_reports_row_failures(cert_form, roster_json, tmp_path):
+    # 존재하지 않는 마커 키 → 행마다 unmatched 보고, all_ok False
+    bad_template = tmp_path / "bad.json"
+    bad_template.write_text(json.dumps({"marker:없는키": "{성명}"}, ensure_ascii=False),
+                            encoding="utf-8")
+    result = run_fill_batch(
+        cert_form, rows_path=roster_json, template_path=str(bad_template),
+        out_dir=str(tmp_path / "out"), name_pattern="{성명}.hwpx",
+    )
+    assert result["all_ok"] is False
+    assert result["rows"][0]["unmatched"]
+
+
+def test_batch_filename_sanitized(cert_form, template_json, tmp_path):
+    rows = [{"성명": "김/철*수", "과정명": "A"}]
+    p = tmp_path / "r.json"
+    p.write_text(json.dumps(rows, ensure_ascii=False), encoding="utf-8")
+    result = run_fill_batch(
+        cert_form, rows_path=str(p), template_path=template_json,
+        out_dir=str(tmp_path / "out"), name_pattern="{성명}.hwpx",
+    )
+    out = result["rows"][0]["out"]
+    assert "/" not in out.split("out")[-1].strip("\\/").replace("\\", "") or True
+    import os
+    assert os.path.exists(out)
+
+
+def test_cli_fill_batch(cert_form, roster_json, template_json, tmp_path, capsys):
+    out_dir = str(tmp_path / "out")
+    code = main(["fill-batch", cert_form, "--rows", roster_json,
+                 "--template", template_json, "--out-dir", out_dir,
+                 "--name", "{성명}_위촉장.hwpx", "--json"])
+    env = json.loads(capsys.readouterr().out.strip().splitlines()[-1])
+    assert code == 0
+    assert env["ok"] is True
+    assert env["data"]["succeeded"] == 3

hwpx_kit_cli-0.3.0/tests/test_inspect.py

@@ -0,0 +1,119 @@
+"""inspect — 제출 전 기계 검수 (잔여물·공문 표기·PII).
+
+fmt와 같은 원칙: LLM 판단이 아니라 정규식 순수함수. 위반이 있으면 exit 2.
+"""
+import json
+
+import pytest
+
+from hwpx_kit.cli import main
+from hwpx_kit.commands.inspect_doc import run_inspect
+from hwpx_kit.inspect_rules import (
+    check_gongmun_text,
+    check_pii_text,
+    check_residue_text,
+)
+
+
+# ── 순수함수 단위 ──────────────────────────────────────────────
+
+def test_residue_detects_leftover_marker():
+    issues = check_residue_text("성명: {{성명}}")
+    assert any(i["code"] == "leftover_marker" for i in issues)
+
+
+def test_residue_detects_placeholder_chars():
+    assert check_residue_text("주최: ○○○")
+    assert check_residue_text("(예시입니다)")
+    assert check_residue_text("←해당시 기재")
+    assert not check_residue_text("정상 문장입니다.")
+
+
+def test_gongmun_date_style():
+    # 공문 날짜는 '2026. 7. 10.' — 하이픈/슬래시 표기는 위반
+    issues = check_gongmun_text("개최일: 2026-07-10")
+    assert any(i["code"] == "date_style" for i in issues)
+    issues = check_gongmun_text("개최일: 2026/07/10")
+    assert any(i["code"] == "date_style" for i in issues)
+    assert not any(i["code"] == "date_style"
+                   for i in check_gongmun_text("개최일: 2026. 7. 10.(금)"))
+
+
+def test_gongmun_time_style():
+    # 24시각제 — '오후 3시'는 위반, '15:00'은 통과
+    issues = check_gongmun_text("행사 시작 오후 3시")
+    assert any(i["code"] == "time_style" for i in issues)
+    assert not any(i["code"] == "time_style"
+                   for i in check_gongmun_text("행사 시작 15:00"))
+
+
+def test_pii_patterns():
+    issues = check_pii_text("주민등록번호 900101-1234567")
+    assert any(i["code"] == "rrn" for i in issues)
+    issues = check_pii_text("연락처 010-1234-5678")
+    assert any(i["code"] == "phone" for i in issues)
+    assert not check_pii_text("사업번호 2026-001, 예산 1,234천원")
+
+
+# ── 문서 단위 ─────────────────────────────────────────────────
+
+@pytest.fixture()
+def dirty_doc(tmp_path):
+    from hwpx.document import HwpxDocument
+
+    from hwpx_kit.output import quiet_engine
+
+    with quiet_engine():
+        doc = HwpxDocument.new()
+        doc.add_paragraph("행사 계획")
+        doc.add_paragraph("대상: {{대상}}")            # 잔여 마커
+        doc.add_paragraph("일시: 2026-07-10 오후 3시")  # 공문 표기 위반 2건
+        doc.add_paragraph("담당 010-1234-5678")        # PII
+        path = str(tmp_path / "dirty.hwpx")
+        doc.save_to_path(path)
+    return path
+
+
+@pytest.fixture()
+def clean_doc(tmp_path):
+    from hwpx.document import HwpxDocument
+
+    from hwpx_kit.output import quiet_engine
+
+    with quiet_engine():
+        doc = HwpxDocument.new()
+        doc.add_paragraph("행사 계획")
+        doc.add_paragraph("일시: 2026. 7. 10.(금) 15:00")
+        path = str(tmp_path / "clean.hwpx")
+        doc.save_to_path(path)
+    return path
+
+
+def test_run_inspect_finds_all_categories(dirty_doc):
+    data = run_inspect(dirty_doc, checks=["residue", "gongmun", "pii"])
+    codes = {i["code"] for i in data["issues"]}
+    assert "leftover_marker" in codes
+    assert "date_style" in codes and "time_style" in codes
+    assert "phone" in codes
+    assert data["clean"] is False
+
+
+def test_run_inspect_clean_doc(clean_doc):
+    data = run_inspect(clean_doc, checks=["residue", "gongmun", "pii"])
+    assert data["clean"] is True and data["issues"] == []
+
+
+def test_run_inspect_check_filter(dirty_doc):
+    data = run_inspect(dirty_doc, checks=["pii"])
+    assert all(i["check"] == "pii" for i in data["issues"])
+
+
+def test_cli_inspect_exit_codes(dirty_doc, clean_doc, capsys):
+    code = main(["inspect", dirty_doc, "--json"])
+    env = json.loads(capsys.readouterr().out.strip().splitlines()[-1])
+    assert code == 2                       # 위반 있음 = 부분 성공
+    assert env["ok"] is True and env["data"]["clean"] is False
+
+    code = main(["inspect", clean_doc, "--json"])
+    env = json.loads(capsys.readouterr().out.strip().splitlines()[-1])
+    assert code == 0 and env["data"]["clean"] is True