md-paper v0.11.2

v0.11.2

Fail-loud safety and documentation correction for the upstream Codex Hook-dispatch regression.

Important compatibility notice

Some current Codex Desktop and non-interactive CLI builds can discover a Hook and show it as Active/Trusted, yet never invoke its handler. This is tracked upstream at openai/codex#21639.

Registration, Trust, restart, and policy self-tests do not prove that the current session is dispatching Hooks. Before write-capable md-swarm / md-iterate work, both real actions printed by probe_live_hooks.py --prepare must be explicitly DENIED.

Changes

• Live-probe failure now stops write-capable work and points to the upstream regression.
• If Codex already shows Active/Trusted but either probe action lands, the guidance no longer loops reinstall / Trust / restart.
• The safe fallback is to switch to a host that passes both live DENY checks, currently Claude Code, and retest Codex only after its runtime or configuration actually changes.
• New self-test assertions keep the upstream link, no-loop instruction, and safe-host fallback from silently disappearing.
• README, INSTALL, CHANGELOG, and the user guide now clarify that v0.11.1 fixed payload-shape compatibility only when the host actually dispatches Hooks.

Upgrade

1. Pull/sync v0.11.2.
2. Re-run the hook installer only if the adapter is missing or untrusted.
3. Run the current-session live probe.
4. If both actions are not explicitly DENIED, stop write-capable md-paper work in that host and use a verified host.

All portable CI checks pass.

---

本版本针对 Codex 上游 Hook 调度回归做“响亮停机”和文档勘误：Active/Trusted 不等于处理器真的执行。写入型 md-swarm / md-iterate 之前，只认 current-session live-probe 的两个明确 DENY。若动作仍落盘，不要继续循环重装、Trust、重启；切换到已经通过双 DENY 的宿主，当前推荐 Claude Code。

md-paper v0.11.1

Warning

Correction (2026-07-28): v0.11.1 fixed Codex apply_patch / shell_command payload-shape handling when the host dispatches the Hook. It does not fix the upstream regression where Codex reports a Hook as Active/Trusted but never invokes its handler. See openai/codex#21639 and the corrective v0.11.2 release. Only two explicit current-session live-probe DENY results prove that the protection layer is active.

v0.11.1

Payload compatibility and runner-hardening patch for md-paper's cross-harness protection layer.

Historical highlights

• Recognizes Codex Desktop's FREEFORM apply_patch payloads and shell_command events when Codex actually dispatches them to the handler.
• Preserves Claude Code support through an allowlisted, shell-neutral Python runner for the existing PowerShell hooks; CC Switch provider changes no longer restore the old cmd /c transport.
• Makes the current-session live probe isolate its two actions, so one failed guard cannot mask the other.
• Improves installer verification and cross-harness guidance; CI covers the policy, runner, installers, preflight, and live-probe self-tests.

Corrected upgrade guidance

Upgrade directly to v0.11.2. Install/review Trust once if the adapter is missing. If Codex already shows Active/Trusted but either real probe action lands, do not loop reinstall / Trust / restart. Stop write-capable md-swarm / md-iterate work and switch to a host that explicitly DENIES both live-probe actions, currently Claude Code.

OneDrive sync transfers the skill source only. Skill junctions, the pandoc toolchain, user-level hook configuration, CC Switch's database, and Codex trust are machine-local.

---

中文勘误： v0.11.1 修复的是 Codex 已经派发 Hook 后，对 apply_patch / shell_command 事件形状的识别；它不能修复 Codex 显示 Active/Trusted 却完全不执行处理器的上游回归。是否真正受保护，只认 current-session live-probe 两个动作都明确 DENY。请直接升级 v0.11.2；若动作仍落盘，不要循环重装、Trust、重启，改用已通过双 DENY 的宿主。

md-paper v0.11

v0.11

P0 hardening and cross-harness protection adapters for Claude Code, Codex, and OpenCode.

Highlights

• Adds shared protection adapters for Codex and OpenCode, while retaining the script-level single-writer and citation safeguards.
• Makes manuscript and citekey updates atomic, preventing a failed later step from rolling back earlier work.
• Makes malformed or empty patch files fail loudly instead of producing a partial changeset.
• Preserves approved citation removals across subsequent batches during reference verification.
• Improves installation guidance for Claude Code, Codex, OpenCode, and Hermes Agent.

Upgrade

Read INSTALL.md, re-run the hook installer, then restart your agent and complete the verification step.

---

P0 稳定性修复与跨工具保护层：Claude Code、Codex、OpenCode 均可使用；安装与验证流程已同步更新。

md-paper v0.1 (beta 测试版)

md-paper v0.1 — early / beta release · 首个公开测试版

A Claude Code skill suite for the last mile from an AI-assisted draft to a submission-ready Word document: ingest Word → revise as a Markdown truth-source → compile back to Word with live Zotero citations, auto figure/table/equation numbering, cross-references, and your own page styles.

用 AI 改论文、同时保住所有 Zotero 引用 / 图 / 表 / 交叉引用的工作流：Word 摄取 → Markdown 真源改稿 → 编回带活 Zotero 域的 Word。

⚠️ This is an early public (beta) release. The engine is battle-tested on the author's real journal submissions, but this is its first exposure to other people's machines and manuscripts. Please read Known Limitations in the README, and open an issue if anything breaks.
⚠️ 首个公开测试版。 引擎已在作者真实投稿中反复验证，但初次面向他人的机器与稿件。请先读 README 的已知限制，出问题请提 issue。

Highlights

• Five skills: md-unpack (ingest) · md-triage (organise revision intents) · md-swarm (parallel batch revision) · md-iterate (single-passage polish) · md-build (compile to Word).
• Live Zotero citation fields, automatic figure/table/equation numbering, working cross-references, and configurable fonts/heading/caption styles.
• Citation safety net: single-writer edits, a "never drop a citation" hard gate, and a fabricated-citation guard.

Install & limits · 安装与限制

See the bilingual README for install steps, requirements, and the six Known Limitations — most importantly: ingest requires Windows + Microsoft Word, and citations must be Zotero + Better BibTeX (EndNote/Citavi not supported).

安装步骤、环境要求、六条已知限制见双语 README——尤其：摄取需 Windows + Word，引用仅支持 Zotero + Better BibTeX。

---

Licensed under Apache-2.0 © 2026 Yuang Panwang (潘王雨昂). Third-party components (pandoc/crossref GPL-2.0, downloaded at setup; Zotero/Lua filters MIT) — see NOTICE.