api-changelog-summarizer

When to invoke

• You have an API change (OpenAPI fragments, endpoint lists, or schema diffs) and need a human-readable changelog.
• You want release notes with clear breaking vs non-breaking classification.

Inputs needed

• A JSON diff describing changes (added/removed/modified endpoints and fields).
• Optional release metadata: version, date, owner.

Workflow

1. Validate diff structure and normalize identifiers.
2. Classify each change as breaking / behavioral / non-breaking.
3. Group by endpoint or component.
4. Generate migration notes (what to update in clients).
5. Output a Markdown changelog with concise bullets.