Gpt_Codex_HWP v0.3.0

Gpt_Codex_HWP v0.3.0

같은 플러그인 폴더를 Codex와 Claude Code 양쪽에서 쓸 수 있게 했습니다. Claude Code용 마켓플레이스와 plugin.json을 추가했고, 운영 의존성은 <CLAUDE_CONFIG_DIR 또는 ~/.claude>/plugin-runtime-data에 Codex와 따로 저장합니다. CI가 검증하는 문서 크기 등급은 100 MiB에서 10 MiB로 낮췄습니다. 10 MiB 초과 512 MiB 이하는 이론상 지원하지만 크기별로 검증하지 않습니다.

공문서 Markdown 초안의 날짜·시각·금액 표기, 항목 기호, 붙임, 「끝」 표시를 근거 규정과 함께 점검하는 선택 플러그인 korean-official-doc을 추가했습니다. 설치를 마친 뒤 ai-slop-thresher, kar-plain, korean-official-doc을 한 번 권하며 자동으로 설치하지 않습니다. 그 밖에 단어 안 밑줄이 기울임으로 바뀌어 사라지던 문제, UNC 경로 처리, 쓰기 실패 보고, 신뢰 경로 Python 탐색, 정규식 처리 시간(ReDoS)을 고쳤습니다.

0.2.x에서 바뀐 동작이 있습니다. UNC 경로로 쓰려면 GPT_CODEX_HWP_ALLOWED_ROOTS에 그 루트를 지정해야 하고, 레이아웃 캐시가 없는 HWPX를 reflow 없이 미리 보면 PREVIEW_REFLOW_REQUIRED를 반환합니다. 자세한 목록은 릴리즈 노트의 「0.2.x에서 바뀐 동작」을 확인하십시오.

HWP 5.x는 읽기 전용이며 생성·수정 결과는 HWPX로 저장합니다. one-shot 도구 9개와 명시적 런타임 설치 절차를 유지합니다. Claude Code는 Windows x64에서만 검증했고, 실제 Mac 기기의 Codex Desktop·Claude Code·한컴오피스 한글은 아직 검증하지 않았습니다.

소스와 배포용 잠금 파일의 운영 의존성 감사 결과는 각각 알려진 취약점 0건입니다. Windows x64·macOS arm64·Linux CI와 보안 정책 검사, 설치 런타임의 nine-tool 스모크, 10 MiB 문서 감지 스모크를 통과했습니다. 첨부 자산은 v0.3.0 불변 태그의 릴리즈 게이트와 attestation을 통과한 같은 실행에서 가져왔으며 SHA256SUMS로 확인할 수 있습니다.

한국어 릴리즈 노트 · English release notes · 설치 안내

Gpt_Codex_HWP v0.2.7

Gpt_Codex_HWP v0.2.7

이슈 #18의 의존성 경고를 수정했습니다. @xmldom/xmldom·sharp를 올리고 fast-uri·hono·qs·ip-address의 수정 버전을 소스와 배포용 잠금 파일에 반영했습니다. HWPX 글꼴 검사의 XML 직렬화를 보완하고, 감사 보고의 advisory 누락과 중복 행을 고쳤습니다.

v0.2.6은 커밋 신원 검사에서 릴리즈 게이트가 중단된 미게시 태그입니다. 태그를 옮기지 않고 같은 수정 내용을 v0.2.7에서 검증했습니다.

HWP 5.x는 읽기 전용이며 생성·수정 결과는 HWPX로 저장합니다. one-shot 도구 9개와 명시적 런타임 설치 절차를 유지합니다. 실제 Mac 기기의 Codex Desktop·한컴오피스 한글은 아직 검증하지 않았습니다.

소스와 배포용 잠금 파일의 운영 의존성 감사 결과는 각각 알려진 취약점 0건입니다. Windows x64·macOS arm64·Linux CI와 보안 정책 검사, 설치 런타임의 HWPX 생성·이미지 삽입·검증, 100 MiB 문서 감지 스모크를 통과했습니다. 첨부 자산은 v0.2.7 불변 태그의 릴리즈 게이트와 attestation을 통과한 같은 실행에서 가져왔으며 SHA256SUMS로 확인할 수 있습니다.

한국어 릴리즈 노트 · English release notes · 설치 안내

Gpt_Codex_HWP v0.2.5

Gpt_Codex_HWP v0.2.5 릴리즈 노트

• 상태: 정식 릴리즈
• 작성일: 2026-08-10
• 검증 기준: Windows x64 개발·실문서 검증, macOS Apple Silicon 실제 기기 미검증

English | README

개요

v0.2.5는 v0.2.2의 HWP 읽기 전용·HWPX 쓰기 원칙, Codex 관리 캐시 밖의 명시적 지속 런타임 설치와 내부 one-shot 도구 계약 9개를 그대로 유지합니다. 불변 v0.2.3과 v0.2.4 태그는 hosted Windows 릴리스 게이트의 실행 이식성 문제를 확인한 뒤 미게시 후보로 보존했으며, 어느 태그에도 GitHub Release나 배포 자산을 만들지 않았습니다. v0.2.5는 같은 전체 테스트 범위를 파일별 제한·격리 실행으로 전환합니다. v0.2.4 후보 대비 사용자 런타임·도구·문서 동작은 바뀌지 않습니다.

주요 변경 사항

• 릴리스 Node 게이트가 루트 테스트 26개와 소스 테스트 41개의 정확한 전체 목록을 파일별로 제한·격리 실행합니다. 테스트를 삭제하거나 검증 범위를 줄이지 않았고, 누락·중복·예상 밖 파일은 fail-closed로 거부합니다.
• 각 파일의 출력·실행 시간·종료 시간을 제한하며 실패 시 허용된 고정 영수증만 남깁니다. 원시 TAP, 오류, 사용자 경로, PID, 환경 변수와 문서 내용은 공개하지 않습니다.
• Windows에서 제한 종료가 필요하면 기존의 하위 프로세스 트리 종료기를 재사용하고 자식 close와 종료 완료를 모두 확인합니다. 일반 Node 테스트와 SVG 진단을 포함한 모든 격리 경로에 같은 규칙을 적용합니다.
• 합성 Git 이력의 심볼릭 링크 모드 검증이 호스트의 core.symlinks 설정에 좌우되지 않도록 해당 임시 저장소의 checkout 명령만 이식 가능하게 만들었습니다. 실제 Git 트리의 120000 모드 검사는 유지합니다.
• hosted runner가 제공하는 별칭 임시 경로를 검증된 canonical 임시 루트로 정규화하고, 환경과 경로 길이에 따라 달라지는 stderr 바이트 수는 기존 1부터 65,537까지의 경계로 검증합니다.
• 관리 플러그인 캐시 밖의 전체 플러그인 버전·플랫폼·아키텍처·Node 주버전별 경로에 검증된 런타임을 원자적으로 설치합니다. 같은 Codex 프로필의 Node 22와 Node 24가 서로의 런타임을 교체하지 않으며, 캐시가 재생성되어도 같은 런타임을 다시 사용합니다. 문서 작업 중에는 설치나 네트워크 접근을 하지 않습니다.
• worker-only·child-only·mixed 종료 영수증을 모두 fail-closed로 집계하고 감독된 나머지 프로세스 트리가 0개인지 검증합니다.
• 소스와 생성 런타임 잠금 파일을 fast-uri 3.1.5, hono 4.13.1, ip-address 10.4.0으로 갱신했으며 두 production audit 모두 알려진 취약점 0개입니다.
• Windows 고부하·콜드 스타트에서 PowerShell ACL 헬퍼가 조기 실패하지 않도록 대기 상한을 15초로 조정했습니다. 적용하는 DACL과 허용 주체는 바꾸지 않았습니다.
• 공개 안정판 설치 안내를 v0.2.5와 기본 one-shot 구조에 맞췄습니다. 기본 설치는 /mcp에 영구 gpt-codex-hwp 서버를 등록하지 않습니다.
• v0.2.2 공개 릴리스와 미게시 v0.2.3·v0.2.4 후보 태그는 변경하지 않았으며 v0.2.5는 새 빌드 ID를 사용합니다.

검증 증거

• 공개 v0.2.2 ZIP의 SHA-256을 공개 SHA256SUMS와 대조했습니다.
• 새 디렉터리 콜드 설치에서 doctor 필수 검사 11/11, 실제 HWP 감지·읽기, HWPX 생성·독립 검증을 통과했습니다.
• Codex 공용 설치 경로의 v0.2.2에서도 설치 런타임 one-shot으로 HWPX를 생성·검증했고 감독된 나머지 하위 프로세스 0개를 확인했습니다.
• 병렬 저장소 테스트 실패를 로컬에서 재현했고, 런타임 의존성 복원 후 해당 스모크 28/28 통과로 공유 트리 경합을 확인했습니다.
• 격리된 Codex 홈에서 런타임을 설치한 뒤 관리 캐시를 의존성 없이 다시 만들고 doctor와 실제 HWPX 생성·검증을 재실행해 설치 영수증 해시가 바뀌지 않음을 확인했습니다.
• 간헐 실패하던 캐시 재생성 회귀 테스트를 수정 후 3회 연속 통과시켰습니다.
• 한 Codex 홈에서 Node 22와 Node 24의 런타임 경로가 분리되고 한쪽 설치가 다른 쪽 디렉터리를 변경하지 않는 회귀 테스트를 추가했습니다.
• worker-only·child-only·mixed one-shot 정리 경로에서 유효한 영수증을 집계하고 감독된 나머지 프로세스 트리 0개를 확인했습니다.
• 최종 정체성의 로컬 권위 실행기에서 루트 Node 테스트 파일 26개와 소스 Node 테스트 파일 41개를 모두 통과했습니다. 릴리스 아티팩트 생성·업로드와 attestation은 같은 불변 태그에 대한 전체 릴리스 게이트가 성공한 뒤에만 실행됩니다.

사용자 자원 사용 안내

미사용 시 상주 Gpt_Codex_HWP Node 프로세스는 0개입니다. 저장소 테스트 직렬화는 CI와 개발 검증의 동시 Node 프로세스 수를 낮추지만 사용자 문서 작업의 고정 RSS 또는 설치 크기 감소를 뜻하지 않으며, 고정 RSS 감소율이나 설치 크기 감소는 주장하지 않습니다.

설치와 업그레이드

v0.2.5를 설치할 때는 설치 결과의 installedPath를 경로·플러그인 identity 규칙으로 먼저 검증한 뒤 그 경로에서 실행합니다.

node dist/install-runtime.js --json
node dist/doctor.js --json

첫 명령은 JSON code RUNTIME_INSTALL_OK를 반환해야 합니다. 실행 중인 모든 Codex CLI와 Desktop 호스트를 완전히 닫았다가 다시 여십시오. 문서 작업 하나를 실행해 성공했는지 확인하고 생성 결과를 검증한 뒤 one-shot 프로세스와 그 하위 프로세스가 종료되는지 확인하십시오. 문서 작업은 설치를 자동 수행하지 않으므로 RUNTIME_NOT_INSTALLED면 검증한 installedPath에서 설치기를 명시적으로 다시 실행합니다. v0.2.2의 관리 캐시 내부 직접 설치는 캐시 재생성 뒤 유지되는 방식이 아니었으므로, v0.2.5 재시작 검증 전에는 기존 작동 버전을 제거하지 마십시오.

운영 의존성은 $CODEX_HOME/plugin-runtime-data/gpt-codex-hwp/<전체-플러그인-버전>/<platform>-<arch>-node<Node-주버전>에 남습니다. 플러그인을 제거한 뒤 정리하려면 모든 Codex 호스트를 종료하고 더 이상 사용하지 않는 정확한 전체 플러그인 버전 디렉터리만 수동으로 제거하십시오. 자동 재귀 삭제 명령은 이번 릴리즈에 포함하지 않습니다.

호환성과 알려진 제한

• Windows x64에서 개발하고 실제 HWP/HWPX 기능을 검증했습니다.
• macOS Apple Silicon은 호환 대상이지만 실제 Mac 기기의 Codex Desktop·한컴오피스 한글에서 검증하지 않았습니다.
• HWP 5.x는 읽기 전용이며 생성·편집 결과는 HWPX입니다. HWP 3.x는 실제 fixture가 없어 보장하지 않습니다.
• 100 MiB까지 CI 검증 범위이며 100 MiB 초과 512 MiB 이하는 비보장 best-effort입니다. 512 MiB 초과는 거부합니다.
• 보호·암호화·서명·DRM 문서는 우회하지 않습니다.
• 글꼴 파일은 포함·설치·내장하지 않습니다.

라이선스와 감사

프로젝트 코드는 Apache-2.0으로 배포합니다. Kordoc, rhwp, hwpx-editing-skill과 기타 제3자 구성 요소는 각 원저작자의 저작권과 라이선스를 따릅니다. 자세한 내용은 THIRD_PARTY_NOTICES.md를 확인하십시오.

이 문서는 v0.2.5 릴리즈에 포함되는 노트입니다.

---

Gpt_Codex_HWP v0.2.5 Release Notes

• Status: final release
• Date: 2026-08-10
• Validation baseline: Windows x64 development and real-document checks; physical Mac unverified

한국어 | README

Overview

v0.2.5 retains v0.2.2's read-only HWP policy, HWPX writing, explicit durable runtime installation outside the Codex-managed cache, and all nine internal one-shot tool contracts. The immutable v0.2.3 and v0.2.4 tags remain unpublished candidates after release-gate execution portability issues were found on hosted Windows; neither tag has a GitHub Release or distribution assets. v0.2.5 runs the same complete coverage through bounded per-file isolation. User runtime, tools, and document behavior are unchanged from the v0.2.4 candidate.

Main changes

• The release Node gate runs the exact complete inventory of 26 root and 41 source test files through bounded per-file isolation. No tests or coverage were removed; missing, duplicate, or unexpected files fail closed.
• Each file has bounded output, execution, and shutdown. Failures expose only allowlisted fixed receipts, never raw TAP, errors, user paths, PIDs, environment variables, or document content.
• Bounded shutdown on Windows reuses the existing descendant-tree terminator and waits for both child close and termination completion. The same rule covers every isolation path, including generic Node and SVG diagnostics.
• Synthetic Git-history symlink-mode validation no longer depends on the host's core.symlinks setting. Only the temporary checkout command is made portable; the committed tree's 120000 mode remains under test.
• Hosted-runner temporary-path aliases are normalized to the verified canonical temporary root, and environment- and path-length-dependent stderr counts retain their existing 1 through 65,537 bound.
• A verified runtime is installed atomically outside the managed plugin cache, scoped by full plugin version, platform, architecture, and Node major. Node 22 and Node 24 in one Codex profile do not replace each other's runtime. Cache rehydration reuses the matching runtime, while document operations perform no installation or network access.
• Worker-only, child-only, and mixed cleanup receipts are aggregated fail-closed, and the runtime verifies zero remaining supervised process trees.
• Source and generated-runtime locks now use fast-uri 3.1.5, hono 4.13.1, and ip-address 10.4.0; both production audits report zero known vulnerabilities.
• The Windows PowerShell ACL helper now allows a 15-second cold-start window under host load. The applied DACL and allowed principals are unchanged.
• Public stable-install guidance now targets v0.2.5 and its default one-shot lifecycle. The default installation does not register a persistent gpt-codex-hwp server in /mcp.
• The public v0.2.2 release and unpublished v0.2.3 and v0.2.4 candidate tags remain unchanged; v0.2.5 uses a new build ID.

Verification evidence

• The public v0.2.2 ZIP SHA-256 matched the published SHA256SUMS manifest.
• A fresh-directory cold install passed all 11 required doctor checks, real HWP detection and reading, HWPX generation, and independent validation.
• The shared Codex v0.2.2 installed-runtime one-shot generated HWPX, validated it, and reported zero remaining supervised descendants.
• The parallel repository failure was reproduced locally; after restoring runtime dependencies, the affected smoke file passed all 28 tests, confirming a shared-tree race.
• An isolated Codex-home regression installed the runtime, rebuilt the managed cache without dependencies, reran doctor and real HWPX generation/validation, and retained the exact installation-receipt hash.
• The previously intermittent cache-rehydration regression passed three consecutive runs after the fix.
• A regression test now proves that Node 22 and Node 24 resolve to separate runtime paths in one Codex home and that installing one does not alter the other directory.
• Worker-only, child-only, and mixed one-shot cleanup paths produced valid aggregated receipts with zero remaining supervised process trees.
• The local authoritative runner passed all 26 root and 41 source Node test files on the final identity. Release artifact build, upload, and attestation run only after the complete release gate succeeds for the same immutable tag.

User resource statement

There are zero persistent Gpt_Codex_HWP Node processes while the plugin is idle. Serial repository tests reduce concurrent Node processes in CI and development validation; they do not establish lower fixed RSS or installation size for user document work. No fixed RSS percentage or installation-size reduction is claimed.

Installation and upgrade

When installing v0.2.5, first validate the returned installedPath against the path and plugin-identity rules, then run from that path:

node dist/install-runtime.js --json
node dist/doctor.js --json

The first command must return JSON code RUNTIME_INSTALL_OK. Fully close and reopen every active Codex CLI and Desktop host. Run one document operation, require it to succeed, verify the generated output, and confirm that the one-shot process and its descendants exit. Document operations never install dependencies automatically; on RUNTIME_NOT_INSTALLED, explicitly rerun the installer from the validated installedPath. The v0.2.2 direct installation inside the managed cache was not durable across cache rehydration, so keep the older working version until v0.2.5 passes the restart check.

Production dependencies remain at $CODEX_HOME/plugin-runtime-data/gpt-codex-hwp/<full-plugin-version>/<platform>-<arch>-node<Node-major>. To clean up after removing a plugin, close every Codex host and manually remove only the exact full-plugin-version directory that is no longer used. This release intentionally provides no automatic recur...

Gpt_Codex_HWP v0.2.2

한국어

v0.2.2는 HWP 읽기 전용·HWPX 쓰기 원칙을 유지하면서 one-shot 실행 수명주기와 100 MiB 검증 범위를 정리한 패치 릴리즈입니다.

• 기본 상주 MCP 서버 없이 작업마다 프로세스를 한 번 실행하며, 사용하지 않을 때 Gpt_Codex_HWP Node 프로세스는 0개입니다.
• HWP는 감지·읽기·미리보기 전용이고 새 문서와 편집 결과는 검증 가능한 HWPX로 저장합니다.
• Windows x64, Linux x64, macOS arm64 hosted runner에서 정확한 100 MiB production one-shot 스모크가 통과했습니다. 100 MiB 초과 512 MiB 이하는 비보장 best-effort입니다.
• 9개 문서 도구 계약과 Kordoc compact core를 유지합니다.
• 실제 Mac 기기의 Codex Desktop·한컴오피스 한글 사용은 아직 미검증입니다.
• ZIP, SPDX SBOM, provenance, SHA-256 체크섬을 함께 제공합니다.

한국어 전체 릴리즈 노트

GitHub-hosted 불변 릴리즈 워크플로는 태그·도구체인·100 MiB 사전 검증을 통과했지만 전체 Node 단계가 hosted runner에서 두 번 실패하여 artifact attestation은 생성되지 않았습니다. 게시 자산은 정확한 불변 v0.2.2 태그의 깨끗한 트리에서 생성했고 저장소의 독립 검증기로 검증했으며, SHA256SUMS와 provenance.json을 포함합니다.

English

v0.2.2 is a patch release that preserves HWP-read-only/HWPX-write behavior while tightening the one-shot lifecycle and the verified 100 MiB envelope.

• There is no default persistent MCP server: each operation runs once, leaving zero persistent Gpt_Codex_HWP Node processes when unused.
• HWP remains detection/read/preview only; new and edited documents are saved as validated HWPX.
• The exact 100 MiB production one-shot smoke passed on Windows x64, Linux x64, and a macOS arm64 hosted runner. Over 100 MiB through 512 MiB remains non-guaranteed best effort.
• All nine document-tool contracts and the compact Kordoc core remain available.
• Codex Desktop and Hancom Office Hangul on a physical Mac remain unverified.
• The release includes a ZIP, SPDX SBOM, provenance, and SHA-256 checksums.

Full English release notes

The GitHub-hosted immutable-release workflow passed tag, toolchain, and 100 MiB preflight checks, but its full Node stage failed twice under hosted-runner variance, so artifact attestations were not produced. The published assets were built from the clean exact immutable v0.2.2 tag, independently verified by the repository verifier, and include SHA256SUMS and provenance.json.

Gpt_Codex_HWP v0.2.1

한국어

Gpt_Codex_HWP의 첫 공개 0.2 계열 릴리스입니다.

• 바이너리 HWP는 안전한 읽기·미리보기 전용이며, 새 문서와 편집 결과는 검증 가능한 HWPX로 작성합니다.
• 공개 런타임은 9개 MCP 도구와 필요한 Kordoc Core만 포함합니다.
• MCP SDK의 전이 의존성 @hono/node-server를 보안 수정판 2.0.11로 고정했습니다.
• Windows x64, macOS arm64, Linux, Security 게이트를 정확한 릴리스 SHA에서 통과했습니다. 실제 Mac 기기의 Codex Desktop·한컴오피스 한글 사용은 아직 미검증입니다.
• ZIP, SPDX SBOM, provenance, SHA-256 체크섬을 함께 제공합니다.

한국어 전체 릴리스 노트

GitHub-hosted artifact attestation은 대용량 합성 문서 단계의 호스티드 러너 자원 불안정으로 이번 게시에서 보류했습니다. 게시 자산은 불변 v0.2.1 태그의 깨끗한 detached worktree에서 생성하고 저장소의 독립 검증기로 검증했으며, SHA256SUMS와 provenance.json을 포함합니다.

English

This is the first public Gpt_Codex_HWP release in the 0.2 series.

• Binary HWP is a safe read/preview-only input; new and edited documents are written as validated HWPX.
• The public runtime contains exactly nine MCP tools and only the required Kordoc Core.
• The MCP SDK's transitive @hono/node-server dependency is pinned to security-fixed 2.0.11.
• Windows x64, macOS arm64, Linux, and Security gates passed at the exact release SHA. Use with Codex Desktop and Hancom Office Hangul on a physical Mac remains unverified.
• The release includes a ZIP, SPDX SBOM, provenance, and SHA-256 checksums.

Full English release notes

GitHub-hosted artifact attestation is deferred because the hosted runner was unstable during the synthetic large-document stage. The published assets were built from a clean detached worktree at immutable tag v0.2.1, independently verified by the repository verifier, and include SHA256SUMS and provenance.json.

Gpt_Codex_HWP v0.1.4

한국어

Gpt_Codex_HWP v0.1.4는 HWP를 읽기 전용 입력으로 처리하고 새 문서와 편집 결과를 HWPX로 작성하는 Windows x64 검증 릴리즈입니다.

주요 변경

• HWP 감지·읽기·미리보기와 HWPX 생성·수정·검증·이미지 삽입을 위한 MCP 도구 9개를 제공합니다.
• 문서 작업에 필요한 인증된 Kordoc 3.18.1 컴팩트 코어만 포함하며 PDF·OCR·ONNX·수식 엔진 선택 의존성은 제외했습니다.
• AWS_SECRET_ACCESS_KEY 등 cloud secret key 탐지를 강화하고, 스킬 메타데이터가 참조하는 아이콘을 공개 런타임에 포함했습니다.
• 사용자 경로, 개인키, 실제 자격증명, .env, 테스트 문서와 사용자 문서가 공개 트리에 포함되지 않았음을 검사했습니다.

검증

• Node: 334개 중 330개 통과, 예상 플랫폼·권한 스킵 4개, 실패 0개
• Python: 16/16 통과
• production npm audit: 알려진 취약점 0개
• 실제 HWP 읽기와 MCP 도구 9개 스모크 통과, stderr 0바이트
• Windows x64 검증 완료; macOS Apple Silicon은 호환 대상이나 실제 기기 미검증

설치는 움직이는 main 대신 v0.1.4 태그를 고정하고, 설치된 플러그인 경로에서 npm ci --omit=dev --ignore-scripts를 실행하십시오. 자세한 절차는 한국어 README와 릴리즈 노트를 참조하십시오.

English

Gpt_Codex_HWP v0.1.4 is a Windows x64-validated release that treats HWP as read-only input and writes all new or edited documents as HWPX.

Highlights

• Provides nine MCP tools for HWP detection, reading, and preview plus HWPX generation, editing, validation, and image insertion.
• Ships only the authenticated compact Kordoc 3.18.1 core required for document workflows; optional PDF, OCR, ONNX, and formula engines are excluded.
• Strengthens cloud-secret detection, including AWS_SECRET_ACCESS_KEY, and includes the icons referenced by skill metadata.
• The public tree was checked for user paths, private keys, literal credentials, .env files, test documents, and user documents.

Verification

• Node: 330 passed out of 334, with 4 expected platform/privilege skips and 0 failures
• Python: 16/16 passed
• Production npm audit: 0 known vulnerabilities
• Real HWP read smoke and all nine MCP tool smokes passed with 0 bytes on stderr
• Windows x64 validated; macOS Apple Silicon is a compatibility target but remains untested on real hardware

Pin the immutable v0.1.4 tag instead of the moving main branch, then run npm ci --omit=dev --ignore-scripts from the installed plugin path. See the English README and release notes for the complete procedure.

Gpt Codex HWP v0.1.3

English

v0.1.3 is the first release published under GitHub release immutability and supersedes older releases for new installs.

v0.1.0–v0.1.2 remain historical releases and were created before release immutability was enabled.

Agent-assisted installation must pin the public release tag and use JSON output:

codex plugin marketplace add Burntgogi/Gpt_Codex_HWP --ref v0.1.3 --json
$installed = codex plugin add gpt-codex-hwp@gpt-codex-hwp-local --json | ConvertFrom-Json

Verify the returned installedPath is the expected absolute cache path and contains the manifest, package metadata, lockfile, and dist/mcp.js. Plugin installation alone does not install production dependencies: run npm ci --omit=dev and npm audit --omit=dev only from that validated installed path. The fully-qualified plugin selector is gpt-codex-hwp@gpt-codex-hwp-local.

Binary HWP is read-only. Read HWP input and write generated or edited output as HWPX.

Validated on Windows x64. macOS Apple Silicon remains unverified.

한국어

v0.1.3은 GitHub 릴리스 불변성이 적용된 첫 릴리스이며, 새 설치에서는 이전 릴리스를 대신해 사용해야 합니다.

v0.1.0–v0.1.2는 릴리스 불변성을 활성화하기 전에 만들어진 역사적 릴리스로 그대로 보존됩니다.

에이전트를 통한 설치에서는 공개 릴리스 태그를 고정하고 JSON 출력을 사용해야 합니다.

codex plugin marketplace add Burntgogi/Gpt_Codex_HWP --ref v0.1.3 --json
$installed = codex plugin add gpt-codex-hwp@gpt-codex-hwp-local --json | ConvertFrom-Json

반환된 installedPath가 예상한 절대 캐시 경로인지, 매니페스트·패키지 메타데이터·잠금 파일·dist/mcp.js를 포함하는지 확인하십시오. 플러그인 설치만으로는 운영 의존성이 설치되지 않으므로, 검증한 설치 경로에서만 npm ci --omit=dev와 npm audit --omit=dev를 실행해야 합니다. 완전한 플러그인 선택자는 gpt-codex-hwp@gpt-codex-hwp-local입니다.

바이너리 HWP는 읽기 전용입니다. HWP를 읽은 뒤 생성하거나 수정한 결과물은 HWPX로 작성하십시오.

Windows x64에서 검증했습니다. macOS Apple Silicon은 호환 대상으로 구성했지만 실제 기기 검증은 아직 완료하지 않았습니다.

Gpt_Codex_HWP v0.1.2

This release supersedes v0.1.1 for new installs because v0.1.1 documented the wrong short pluginId assertion. The Codex CLI returns the fully qualified plugin ID gpt-codex-hwp@gpt-codex-hwp-local.

Codex copies the plugin, but the agent must run npm ci --omit=dev from the validated absolute installedPath returned by the install command before starting the MCP server.

HWP support is read-only. Writable document output is HWPX.

Windows x64 is validated. macOS Apple Silicon is compatible-targeted but unverified.

Gpt_Codex_HWP v0.1.1

Installation requirement

codex plugin add copies the plugin but does not install Node dependencies. Agents must use the tagged installation result's validated installedPath, then run npm ci --omit=dev from that exact path and audit the production dependency set as documented in the README.

Compatibility and safety

• HWP remains read-only; writable document generation and editing use HWPX.
• Windows x64 is validated for this release.
• macOS Apple Silicon remains unverified.

Gpt_Codex_HWP v0.1.0

Gpt_Codex_HWP v0.1.0

First public release of the local Codex plugin for Korean HWP/HWPX document workflows.

Highlights

• Nine MCP tools for detection, reading, HWPX generation, validation, preview, preserve-format editing, form filling, SVG/PNG assets, and image insertion
• Binary HWP 5.x is read-only; generated and edited output uses HWPX
• Context-safe large-document reading with derived Markdown output
• Font-reference integrity validation and structure-preserving HWPX operations
• Path, ZIP, XML, protected-document, output-overwrite, and resource-limit defenses

Platform status

• Windows x64: developed and validated
• macOS Apple Silicon: compatibility target; real-device smoke test not yet completed
• Requires Node.js 22 or newer
• Python 3.10 or newer is required only for after-paragraph image insertion

---

한국어 HWP/HWPX 문서 작업을 위한 로컬 Codex 플러그인의 첫 공개 배포입니다.

• 바이너리 HWP 5.x는 읽기 전용이며 생성·편집 결과는 HWPX로 작성합니다.
• Windows x64에서 제작·검증했습니다.
• macOS Apple Silicon은 호환 대상이지만 실제 기기 검증 전입니다.
• 설치 및 제한 사항은 한국어/영문 README를 확인하십시오.