wigolo diff

Structural comparison of two page versions. Point it at a live URL and its cached copy, two URLs, or two raw markdown blobs, and it returns a git-style patch, structured per-section hunks, or a counts-only summary.

Quick Reference

// Live page vs its cached version (re-fetches `new` side)
{ "old": { "url": "https://docs.example.com/api" }, "new": { "url": "https://docs.example.com/api" } }

// Two different URLs
{ "old": { "url": "https://v1.example.com/spec" }, "new": { "url": "https://v2.example.com/spec" } }

// Two markdown blobs directly
{ "old": { "markdown": "# Title\nold body" }, "new": { "markdown": "# Title\nnew body" } }

// Structured per-section hunks at word granularity
{ "old": { "url": "https://example.com" }, "new": { "url": "https://example.com" }, "output": "hunks", "granularity": "word" }

// Counts only
{ "old": { "url": "https://example.com" }, "new": { "url": "https://example.com" }, "output": "summary" }

Parameters

Parameter	Type	Default	When to use
old	object	required	Left-hand side. One of { url, markdown, content_hash }
new	object	required	Right-hand side. One of { url, markdown }
output	string	"unified"	"unified" (git-style patch), "hunks" (per-section), "summary" (counts only)
granularity	string	"line"	"line", "word" (changed tokens only, tighter), "section" (walks H1/H2/H3)

Output Shapes

• unified, a git-style unified patch, ready to read or store.
• hunks, structured per-section change blocks. Combine with granularity: "section" to align hunks to headings, or granularity: "word" for tight intra-line edits.
• summary, counts only: added_lines, removed_lines, modified_lines, and total_changed_chars (sum of added + removed line chars across the edit script). Cheapest way to answer "did anything change, and how much".

Comparing Against the Cache