kordoc-compare-documents

name	kordoc-compare-documents
description	Use when diffing two Korean documents with `npx` and kordoc. Covers HWP, HWPX, and cross-format comparisons for requests such as 신구대조표 preparation, change review between document versions, block-level additions and removals, or invoking `kordoc:compare_documents` on two local files.

kordoc: compare_documents

Reproduce the compare_documents logic from src/mcp.ts with the public compare export.

Input Requirements

• Require exactly two target documents.
• Require the user to attach both documents or provide two concrete local paths.
• Accept only supported formats: .hwp, .hwpx, .pdf.
• Do not proceed if either document is missing.
• Preserve the user-provided ordering so source and target are not swapped implicitly.

Command

npm exec --yes --package=kordoc --package=pdfjs-dist -- node <<'SCRIPT'
const p = require("path"), fs = require("fs");
const nmBin = process.env.PATH.split(p.delimiter).find(d => d.endsWith(".bin"));
const kUrl = "file:///" + p.join(p.resolve(nmBin, ".."), "kordoc", "dist", "index.js").split(p.sep).join("/");
import(kUrl).then(async (k) => {
  const fileA = "/abs/path/old.hwpx";
  const fileB = "/abs/path/new.hwpx";
  const rawA = fs.readFileSync(fileA);
  const rawB = fs.readFileSync(fileB);
  const bufA = rawA.buffer.slice(rawA.byteOffset, rawA.byteOffset + rawA.byteLength);
  const bufB = rawB.buffer.slice(rawB.byteOffset, rawB.byteOffset + rawB.byteLength);
  const result = await k.compare(bufA, bufB);
  console.log(JSON.stringify(result, null, 2));
}).catch(e => { console.error(e); process.exit(1); });
SCRIPT

Workflow

1. Resolve both files to absolute paths.
2. Run compare.
3. Read stats first: added, removed, modified, unchanged.
4. Summarize the major deltas instead of repeating unchanged blocks.
5. Keep source and target ordering explicit.

Guardrails

• Call out when the comparison is cross-format.
• Do not overstate semantic meaning from block-level diffs.
• Separate added, removed, and modified content in the final explanation.
• Refuse to continue when fewer than two supported documents were provided.