medsci-skills 4.1.0

package/skills/manage-refs/scripts/render_pandoc.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+# render_pandoc.sh — Pandoc citeproc wrapper for manuscript rendering with journal CSL.
+# (Renamed from render_manuscript.sh on 2026-05-01 when relocated to /manage-refs.)
+#
+# Usage:
+#   render_manuscript.sh -j <journal> -i <input.md> -b <refs.bib> [-o <out.docx>] [-t <reference.docx>] [-- <extra pandoc args>]
+#
+# Example:
+#   render_manuscript.sh -j european-radiology -i manuscript.md -b references.bib -o manuscript_v4.docx
+#
+# Citation syntax in markdown body: [@bibkey] or [@key1; @key2]
+# References section is auto-generated by pandoc citeproc — do NOT hand-write a References list.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CSL_DIR="${SCRIPT_DIR}/../citation_styles"
+
+usage() {
+  cat >&2 <<EOF
+Usage: $(basename "$0") -j <journal> -i <input.md> -b <refs.bib> [-o <out>] [-t <reference.docx>] [-f <format>]
+
+Options:
+  -j  Journal CSL name (without .csl). Examples: european-radiology, radiology,
+      american-journal-of-roentgenology, cardiovascular-and-interventional-radiology,
+      korean-journal-of-radiology, vancouver. See \${CSL_DIR}/README.md.
+  -i  Input markdown manuscript
+  -b  BibTeX bibliography file
+  -o  Output path (default: <input>.docx). Format inferred from extension.
+  -t  Optional Word reference .docx for styles/fonts
+  -f  Force output format (docx|pdf|html). Default: from -o extension or docx.
+  -h  Help
+
+Pass-through: any args after '--' go directly to pandoc.
+EOF
+  exit 1
+}
+
+JOURNAL=""
+INPUT=""
+BIB=""
+OUTPUT=""
+REFDOC=""
+FORMAT=""
+
+while getopts ":j:i:b:o:t:f:h" opt; do
+  case "$opt" in
+    j) JOURNAL="$OPTARG" ;;
+    i) INPUT="$OPTARG" ;;
+    b) BIB="$OPTARG" ;;
+    o) OUTPUT="$OPTARG" ;;
+    t) REFDOC="$OPTARG" ;;
+    f) FORMAT="$OPTARG" ;;
+    h|*) usage ;;
+  esac
+done
+shift $((OPTIND - 1))
+
+[[ -z "$JOURNAL" || -z "$INPUT" || -z "$BIB" ]] && usage
+
+CSL_FILE="${CSL_DIR}/${JOURNAL}.csl"
+if [[ ! -f "$CSL_FILE" ]]; then
+  echo "ERROR: CSL not found: $CSL_FILE" >&2
+  echo "Available styles:" >&2
+  ls -1 "${CSL_DIR}" | grep '\.csl$' | sed 's/\.csl$//' | sed 's/^/  /' >&2
+  exit 2
+fi
+[[ -f "$INPUT" ]] || { echo "ERROR: input not found: $INPUT" >&2; exit 2; }
+[[ -f "$BIB" ]]   || { echo "ERROR: bib not found: $BIB" >&2; exit 2; }
+
+if [[ -z "$OUTPUT" ]]; then
+  OUTPUT="${INPUT%.*}.docx"
+fi
+if [[ -z "$FORMAT" ]]; then
+  case "${OUTPUT##*.}" in
+    docx) FORMAT="docx" ;;
+    pdf)  FORMAT="pdf" ;;
+    html) FORMAT="html" ;;
+    *)    FORMAT="docx" ;;
+  esac
+fi
+
+ARGS=(--citeproc --csl="$CSL_FILE" --bibliography="$BIB" -t "$FORMAT" -o "$OUTPUT")
+[[ -n "$REFDOC" && -f "$REFDOC" ]] && ARGS+=(--reference-doc="$REFDOC")
+
+echo "[render] journal=$JOURNAL csl=$(basename "$CSL_FILE") in=$INPUT bib=$BIB out=$OUTPUT" >&2
+pandoc "${ARGS[@]}" "$@" "$INPUT"
+echo "[render] ok → $OUTPUT" >&2

package/skills/manage-refs/skill.yml

@@ -0,0 +1,70 @@
+schema_version: 2
+name: manage-refs
+layer: A
+owner_domain: manuscript_lifecycle
+when_to_use:
+  - Render manuscript.md to journal-styled DOCX/PDF/HTML via pandoc citeproc
+  - Validate citation keys (`[@bibkey]`) against refs.bib before build
+  - Cross-reference QC between manuscript markdown and rendered DOCX (--strict)
+  - Convert citation markers `[N]` ↔ `[@key]` for cascade rejection or CWYW handoff
+  - Inject Zotero CWYW field codes for co-author Word workflow (Phase 3 hybrid)
+when_NOT_to_use:
+  - Reference verification against PubMed/CrossRef (use /verify-refs — audit-only)
+  - Adding new references to the library (use /search-lit then /lit-sync)
+  - Drafting manuscript prose (use /write-paper or /revise)
+  - Hand-typing the References list (forbidden — Zotero CWYW or pandoc citeproc only)
+inputs:
+  - manuscript/manuscript.md
+  - manuscript/_src/refs.bib
+  - n_to_zotero_key map (json or csv, optional, for CWYW workflow)
+outputs:
+  - manuscript_final.docx (or .pdf / .html — pandoc citeproc render)
+  - manuscript_cwyw.docx (Zotero CWYW field codes)
+  - qc/xref_audit.json
+deterministic_scripts:
+  - scripts/check_citation_keys.py
+  - scripts/check_xref.py
+  - scripts/render_pandoc.sh
+  - scripts/md_marker_convert.py
+  - scripts/inject_zotero_cwyw.py
+side_effects:
+  - writes_manuscript_artifacts
+  - writes_qc_artifacts
+  - reads_zotero_local_api  # port 23119 for CWYW workflow only
+downstream_consumers:
+  - write-paper
+  - revise
+  - peer-review
+  - sync-submission
+  - find-journal
+  - self-review
+forbidden_actions:
+  - hand_type_references_list
+  - invent_zotero_metadata
+  - guess_citekey_for_unmapped_marker
+  - bypass_check_citation_keys_gate
+  - patch_post_cwyw_docx_with_regex
+provenance:
+  - scripts/_vendor_citation_writer.py:
+      source: alisoroushmd/zotero-mcp
+      sha: ed5dfb718b78f355f300545eb375aec7a543e027
+      license: MIT
+      vendored: 2026-05-01
+quality_gates:
+  - check_citation_keys.py: hard exit on UNDEFINED keys
+  - check_xref.py --strict: hard exit on MISSING_DOCX / MISSING_BODY / MISMATCH
+  - verify-refs hand-off: required before sign-off
+  - cwyw_first_build_user_step: Add/Edit Bibliography in Word
+
+# v2.1 quality card
+purpose: "Manage the reference lifecycle: citekey validation, CSL rendering (pandoc citeproc), Zotero CWYW injection, marker conversion, and cross-reference QC."
+safety_boundaries:
+  - "References are never hand-typed; only Better BibTeX / citeproc / CWYW produce the list."
+  - "Citekeys are validated against the .bib; unmapped markers are not guessed; CWYW docx is not regex-patched."
+known_limitations:
+  - "Pandoc/Zotero must be installed; rendering is deterministic but environment-dependent."
+  - "Phase 3 CWYW field safety depends on a correct Zotero library."
+validation_commands:
+  - "python3 scripts/check_citation_keys.py manuscript.md refs.bib"
+  - "python3 scripts/check_xref.py --md manuscript.md --docx out.docx --strict"
+evidence_surface: bundled_script

package/skills/manage-refs/tests/fixtures/pre_submission_gate/README.md

@@ -0,0 +1,32 @@
+# Regression fixture: pre_submission_gate.sh
+
+End-to-end test for the four-stage chain
+`check_citation_keys` → `verify_refs --strict` → `render_pandoc` (optional) → `check_xref --strict`.
+
+## Layout
+
+- `manuscript.md` — minimal IMRAD-shaped markdown with 3 valid `[@key]` cites, a Figure 1 mention, and a Table 1 mention.
+- `refs.bib` — 3 real entries (Rinella 2023 MASLD multisociety consensus, Vandenbroucke 2007 STROBE E&E, Fine–Gray 1999) all with verifiable DOI + PMID.
+- `run.sh` — invokes `pre_submission_gate.sh` in two modes and asserts the expected exit code and `submission_safe` value for each.
+- `expected/pre_submission_gate.pass.summary.json` — golden minimal summary for the `--allow-separate-attachments` PASS path (compared as JSON, not byte-for-byte; timestamps and full per-stage logs are excluded from the comparison).
+
+## What is verified
+
+- Stage 1 passes: `[@key]` ↔ `.bib` keys all resolve.
+- Stage 2 passes: `verify_refs.py --strict` reports OK for the 3 real DOIs (requires network).
+- Stage 3 is SKIPPED because the harness supplies a pre-rendered DOCX placeholder.
+- Stage 4 default mode FAILS with `MISSING_DOCX > 0` (Figure 1 + Table 1 are cited but not in the placeholder DOCX).
+- Stage 4 `--allow-separate-attachments` mode PASSES with the same DOCX (MISSING_DOCX downgraded to WARN).
+
+## Running
+
+```bash
+bash run.sh
+```
+
+Exit code 0 = both invariants hold; non-zero = regression.
+
+## What is NOT verified by this fixture
+
+- The full `verify_refs.py` per-entry record schema is deferred to the verify-refs unit tests.
+- Network failures during stage 2 are reported as a fixture skip, not a regression (the test runner is expected to be offline-tolerant for CI environments without network).

package/skills/manage-refs/tests/fixtures/pre_submission_gate/manuscript.md

@@ -0,0 +1,10 @@
+# Manuscript fixture for pre_submission_gate.sh regression test
+
+## Introduction
+
+A reference to the 2023 SLD nomenclature update [@Rinella_2023_MASLD] establishes the
+analytic taxonomy used throughout the test fixture, and the STROBE explanation-and-elaboration
+guidance underpins the reporting frame [@Vandenbroucke_2007_STROBE_EE]. The Fine–Gray
+subdistribution-hazard formulation is the canonical competing-risks reference [@FineGray_1999_Subdistribution].
+
+The cohort flow is summarised in Figure 1, and the per-stratum counts appear in Table 1.

package/skills/manage-refs/tests/fixtures/pre_submission_gate/refs.bib

@@ -0,0 +1,34 @@
+@article{Rinella_2023_MASLD,
+  author    = {Rinella, Mary E. and Lazarus, Jeffrey V. and Ratziu, Vlad and Francque, Sven M. and Sanyal, Arun J. and Kanwal, Fasiha and others},
+  title     = {A multisociety {Delphi} consensus statement on new fatty liver disease nomenclature},
+  journal   = {Hepatology},
+  year      = {2023},
+  volume    = {78},
+  number    = {6},
+  pages     = {1966--1986},
+  doi       = {10.1097/HEP.0000000000000520},
+  pmid      = {37363821}
+}
+
+@article{Vandenbroucke_2007_STROBE_EE,
+  author    = {Vandenbroucke, Jan P. and von Elm, Erik and Altman, Douglas G. and G{\o}tzsche, Peter C. and Mulrow, Cynthia D. and Pocock, Stuart J. and Poole, Charles and Schlesselman, James J. and Egger, Matthias},
+  title     = {Strengthening the {Reporting} of {Observational Studies} in {Epidemiology} ({STROBE}): explanation and elaboration},
+  journal   = {Annals of Internal Medicine},
+  year      = {2007},
+  volume    = {147},
+  number    = {8},
+  pages     = {W163--W194},
+  doi       = {10.7326/0003-4819-147-8-200710160-00010-w1},
+  pmid      = {17938389}
+}
+
+@article{FineGray_1999_Subdistribution,
+  author    = {Fine, Jason P. and Gray, Robert J.},
+  title     = {A proportional hazards model for the subdistribution of a competing risk},
+  journal   = {Journal of the American Statistical Association},
+  year      = {1999},
+  volume    = {94},
+  number    = {446},
+  pages     = {496--509},
+  doi       = {10.1080/01621459.1999.10474144}
+}

package/skills/manage-refs/tests/fixtures/pre_submission_gate/run.sh

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+# Regression test for pre_submission_gate.sh.
+#
+# Verifies the orchestration contract end-to-end:
+#   - default mode (no --allow-separate-attachments): stage 4 fails on
+#     MISSING_DOCX, chain exits non-zero, submission_safe=false.
+#   - --allow-separate-attachments mode: stage 4 downgrades MISSING_DOCX
+#     to WARN, chain exits zero, submission_safe=true.
+#
+# Stage 2 (verify_refs --strict) requires network. If the network call
+# fails, the fixture skips with exit code 77 (autotools "SKIP" convention)
+# rather than reporting a regression.
+
+set -uo pipefail
+
+FIXTURE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+GATE="${FIXTURE_DIR}/../../../scripts/pre_submission_gate.sh"
+WORK_DIR="$(mktemp -d -t pre_submission_gate_test.XXXXXX)"
+trap 'rm -rf "$WORK_DIR"' EXIT
+
+MD="$WORK_DIR/manuscript.md"
+BIB="$WORK_DIR/refs.bib"
+DOCX="$WORK_DIR/placeholder.docx"
+QC_DEFAULT="$WORK_DIR/qc_default"
+QC_RELAXED="$WORK_DIR/qc_relaxed"
+
+cp "$FIXTURE_DIR/manuscript.md" "$MD"
+cp "$FIXTURE_DIR/refs.bib"      "$BIB"
+
+# Synthesize a minimal valid .docx (zip with the OOXML skeleton). This DOCX
+# intentionally contains NO Figure 1 / Table 1 captions so that stage 4 finds
+# them MISSING_DOCX. The pre-rendered placeholder skips stage 3.
+python3 - "$DOCX" <<'PY'
+import sys, zipfile
+out = sys.argv[1]
+with zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED) as z:
+    z.writestr(
+        "[Content_Types].xml",
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        '<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">'
+        '<Default Extension="xml" ContentType="application/xml"/>'
+        '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>'
+        '<Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>'
+        '</Types>',
+    )
+    z.writestr(
+        "_rels/.rels",
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+        '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/>'
+        '</Relationships>',
+    )
+    z.writestr(
+        "word/document.xml",
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+        '<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">'
+        '<w:body><w:p><w:r><w:t>Placeholder body without Figure or Table captions.</w:t></w:r></w:p></w:body>'
+        '</w:document>',
+    )
+PY
+
+echo "==== Test 1: default mode must FAIL on MISSING_DOCX ===="
+set +e
+bash "$GATE" \
+    --md "$MD" --bib "$BIB" --docx "$DOCX" --qc-dir "$QC_DEFAULT" \
+    > "$WORK_DIR/default.log" 2>&1
+RC1=$?
+set -e
+
+# If stage 2 failed because of network, skip the entire fixture gracefully.
+if grep -q '"verify_refs", "status": "FAIL"' "$QC_DEFAULT/pre_submission_gate.json" 2>/dev/null \
+   || grep -qiE "network|connection|temporary failure|name resolution" "$WORK_DIR/default.log"; then
+  echo "[SKIP] verify_refs stage failed (likely network-restricted environment)."
+  cat "$WORK_DIR/default.log"
+  exit 77
+fi
+
+if [[ "$RC1" -eq 0 ]]; then
+  echo "FAIL: default mode unexpectedly passed (expected MISSING_DOCX-induced failure)." >&2
+  cat "$WORK_DIR/default.log" >&2
+  exit 1
+fi
+if ! grep -q '"submission_safe": false' "$QC_DEFAULT/pre_submission_gate.json"; then
+  echo "FAIL: default mode did not write submission_safe:false." >&2
+  cat "$QC_DEFAULT/pre_submission_gate.json" >&2
+  exit 1
+fi
+echo "  OK: default mode FAIL with submission_safe:false (rc=$RC1)"
+
+echo "==== Test 2: --allow-separate-attachments mode must PASS ===="
+set +e
+bash "$GATE" \
+    --md "$MD" --bib "$BIB" --docx "$DOCX" \
+    --allow-separate-attachments --qc-dir "$QC_RELAXED" \
+    > "$WORK_DIR/relaxed.log" 2>&1
+RC2=$?
+set -e
+
+if [[ "$RC2" -ne 0 ]]; then
+  echo "FAIL: --allow-separate-attachments mode exited non-zero (rc=$RC2)." >&2
+  cat "$WORK_DIR/relaxed.log" >&2
+  exit 1
+fi
+if ! grep -q '"submission_safe": true' "$QC_RELAXED/pre_submission_gate.json"; then
+  echo "FAIL: --allow-separate-attachments mode did not write submission_safe:true." >&2
+  cat "$QC_RELAXED/pre_submission_gate.json" >&2
+  exit 1
+fi
+if ! grep -q '"allow_separate_attachments": true' "$QC_RELAXED/xref_audit.json"; then
+  echo "FAIL: xref_audit.json did not record the policy flag." >&2
+  cat "$QC_RELAXED/xref_audit.json" >&2
+  exit 1
+fi
+echo "  OK: --allow-separate-attachments PASS with submission_safe:true (rc=$RC2)"
+
+echo "==== All regression invariants hold ===="
+exit 0

package/skills/manage-refs/tests/test_vN_docx_check.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+# Regression tests for check_xref.py --vN-docx-md5 / --vN-md flags.
+#
+# Builds minimal synthetic docx files via zipfile (no pandoc/Word required).
+
+set -uo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
+SCRIPT="$REPO_ROOT/skills/manage-refs/scripts/check_xref.py"
+TMP="$(mktemp -d -t vN_docx_xref.XXXXXX)"
+trap 'rm -rf "$TMP"' EXIT
+
+[[ -f "$SCRIPT" ]] || { echo "ENV-ERR: script missing" >&2; exit 2; }
+
+fail=0
+ran=0
+assert_exit() {
+    local label="$1" expected="$2" actual="$3"
+    ran=$((ran + 1))
+    if [[ "$expected" == "$actual" ]]; then
+        printf '  PASS  %-50s exit=%s\n' "$label" "$actual"
+    else
+        printf '  FAIL  %-50s expected=%s actual=%s\n' "$label" "$expected" "$actual"
+        fail=$((fail + 1))
+    fi
+}
+
+# Helper: build a minimal docx with given body text.
+build_docx() {
+    local body_text="$1"
+    local out="$2"
+    python3 - "$body_text" "$out" <<'PY'
+import sys, zipfile
+body_text, out = sys.argv[1], sys.argv[2]
+doc_xml = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n'
+    '<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">'
+    '<w:body><w:p><w:r><w:t xml:space="preserve">' + body_text + '</w:t></w:r></w:p>'
+    '</w:body></w:document>'
+)
+content_types = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+    '<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">'
+    '<Default Extension="xml" ContentType="application/xml"/>'
+    '<Override PartName="/word/document.xml" '
+    'ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>'
+    '</Types>'
+)
+rels = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+    '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    '<Relationship Id="rId1" '
+    'Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" '
+    'Target="word/document.xml"/></Relationships>'
+)
+with zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED) as z:
+    z.writestr("[Content_Types].xml", content_types)
+    z.writestr("_rels/.rels", rels)
+    z.writestr("word/document.xml", doc_xml)
+PY
+}
+
+# --------------------------------------------------------------------------
+# Setup: minimal manuscript markdown + docx
+# --------------------------------------------------------------------------
+VN_MD="$TMP/v1.md"
+cat > "$VN_MD" <<'EOF'
+# Manuscript
+
+## Methods
+The cohort included 100 patients.
+
+## Figure Legends
+**Figure 1.** Pipeline overview.
+EOF
+NEW_MD="$TMP/v2.md"
+cat > "$NEW_MD" <<'EOF'
+# Manuscript
+
+## Methods
+The cohort included 100 patients enrolled across three sites in this prospective study.
+
+## Figure Legends
+**Figure 1.** Pipeline overview.
+EOF
+
+VN_DOCX="$TMP/v1.docx"
+NEW_DOCX_REGEN="$TMP/v2_regen.docx"
+NEW_DOCX_COPY="$TMP/v2_copy.docx"
+NEW_DOCX_STALE="$TMP/v2_stale.docx"
+
+build_docx "The cohort included 100 patients. Figure 1 Pipeline overview." "$VN_DOCX"
+# Regenerated docx: contains the new diff line verbatim.
+build_docx "The cohort included 100 patients enrolled across three sites in this prospective study. Figure 1 Pipeline overview." "$NEW_DOCX_REGEN"
+# "Copy" docx: byte-identical to v_N.
+cp "$VN_DOCX" "$NEW_DOCX_COPY"
+# Stale docx: different bytes than v_N but missing the new markdown line.
+build_docx "Some text that differs from v_N but lacks the markdown diff." "$NEW_DOCX_STALE"
+
+# --------------------------------------------------------------------------
+# Case 1: regenerated docx contains markdown diff. PASS.
+# --------------------------------------------------------------------------
+python3 "$SCRIPT" --md "$NEW_MD" --docx "$NEW_DOCX_REGEN" \
+    --vN-docx-md5 "$VN_DOCX" --vN-md "$VN_MD" \
+    --out "$TMP/c1.json" --quiet
+assert_exit "case 1: regenerated docx, diff propagated" 0 $?
+
+# --------------------------------------------------------------------------
+# Case 2: identical bytes. FAIL.
+# --------------------------------------------------------------------------
+python3 "$SCRIPT" --md "$NEW_MD" --docx "$NEW_DOCX_COPY" \
+    --vN-docx-md5 "$VN_DOCX" --vN-md "$VN_MD" \
+    --out "$TMP/c2.json" --quiet
+assert_exit "case 2: identical bytes (FAIL)" 1 $?
+python3 - "$TMP/c2.json" <<'PY' || fail=$((fail + 1))
+import json, sys
+with open(sys.argv[1]) as fh: rep = json.load(fh)
+assert rep["vN_docx_check"]["identical_bytes"] is True, rep
+PY
+
+# --------------------------------------------------------------------------
+# Case 3: different bytes but missing diff line. FAIL.
+# --------------------------------------------------------------------------
+python3 "$SCRIPT" --md "$NEW_MD" --docx "$NEW_DOCX_STALE" \
+    --vN-docx-md5 "$VN_DOCX" --vN-md "$VN_MD" \
+    --out "$TMP/c3.json" --quiet
+assert_exit "case 3: different bytes, missing diff (FAIL)" 1 $?
+python3 - "$TMP/c3.json" <<'PY' || fail=$((fail + 1))
+import json, sys
+with open(sys.argv[1]) as fh: rep = json.load(fh)
+assert rep["vN_docx_check"]["identical_bytes"] is False, rep
+assert rep["vN_docx_check"]["diff_line_misses"], rep
+PY
+
+# --------------------------------------------------------------------------
+# Case 4: --vN-docx-md5 without --docx. Should error (exit 2).
+# --------------------------------------------------------------------------
+python3 "$SCRIPT" --md "$NEW_MD" \
+    --vN-docx-md5 "$VN_DOCX" --vN-md "$VN_MD" \
+    --out "$TMP/c4.json" --quiet 2>/dev/null
+assert_exit "case 4: --vN-docx-md5 without --docx" 2 $?
+
+echo ""
+echo "ran=$ran fail=$fail"
+[[ $fail -eq 0 ]]